PVECTORED_EXCEPTION_HANDLER callback function (winnt.h)

Article
02/22/2024

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

PVECTORED_EXCEPTION_HANDLER PvectoredExceptionHandler;

LONG PvectoredExceptionHandler(
  [in] _EXCEPTION_POINTERS *ExceptionInfo
)
{...}

Parameters

[in] ExceptionInfo

A pointer to an EXCEPTION_POINTERS structure that receives the exception record.

Return value

To return control to the point at which the exception occurred, return EXCEPTION_CONTINUE_EXECUTION (0xffffffff). To continue the handler search, return EXCEPTION_CONTINUE_SEARCH (0x0).

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.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	winnt.h (include Windows.h)