Returns the address and exception-handling mode for any of the following:

• Current thread's exception handler
• Current process' exception handler
• System-wide exception handler
• System-wide hardware exception handler (trap handler)

The system-wide exception handler refers to the root process' exception handler. When you change the system-wide exception handler, it changes only the default exception handler that is inherited by first-level processes created by the RT application loader.

Returns both the address of the calling thread's exception handler and the current value of the thread's exception mode.

BOOLEAN GetRtExceptionHandlerInfo(
    BYTE bHandlerID,      // exception handler ID
    PEXCEPTION lpInfo    // pointer to an EXCEPTION structure
);

Parameters

bHandlerID

Specify the exception handler whose address and mode is to be returned, using one of the following values:

THREAD_HANDLER	Thread's exception handler
PROCESS_HANDLER	Process' default exception handler
SYSTEM_HANDLER	System-wide exception handler
HARDWARE_HANDLER	System-wide hardware exception handler
DELETE_PROCESS_HANDLER	System process deletion exception handler
DELETE_THREAD_HANDLER	System thread deletion exception handler
SUSPENSION_HANDLER	System thread suspension exception handler

lpInfo

Pointer to the EXCEPTION structure where information about the required exception handler is stored by the function.

Return Values

TRUE

Success

FALSE

To determine the status, call GetLastRtError

Status

E_OK 0x0000

No exceptional conditions occurred.

E_BAD_ADDR 0x800F

lpInfo is invalid. One of these conditions exist:

• All or part of lpInfo is outside the calling thread's virtual address space.
• The virtual address space has no associated physical memory.

E_PARAM 0x8004

bHandlerID contains a value outside the allowable range.

Requirements

See Also

Exception handler system calls