Share via


VectoredHandler (Windows Embedded CE 6.0)

1/6/2010

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

Other Resources

New Kernel APIs