VectoredHandler
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
This function is an application-defined function that serves as a vectored exception handler. Specify this address when calling the AddVectoredExceptionHandler function. The PVECTORED_EXCEPTION_HANDLER type defines a pointer to this callback function. VectoredHandler is a placeholder for the application-defined name.
Syntax
LONG CALLBACK VectoredHandler(
PEXCEPTION_POINTERS ExceptionInfo
);
Parameters
- ExceptionInfo
[in] Pointer to an EXCEPTION_POINTERS structure that receives the exception record.
Return Value
- EXCEPTION_CONTINUE_EXECUTION (0xffffffff)
Return control to the point at which the exception occurred.
- EXCEPTION_CONTINUE_SEARCH (0x0)
Continue the handler search.
Remarks
The handler should not call functions that acquire synchronization objects or allocate memory, because this can cause problems. Typically, the handler will simply access the exception record and return.
Vectored exception handlers are not frame-based handlers. Therefore, you can add a handler and ensure that it gets called regardless of where you are in a call frame. The handlers are called in the order that they were added, after the debugger gets a first chance notification, but before frame-based dispatching occurs.
Requirements
| Header | winbase.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows Embedded CE 6.0 and later |
See Also
Reference
Exception Functions
AddVectoredExceptionHandler
RemoveVectoredExceptionHandler
EXCEPTION_POINTERS