nf-errhandlingapi-addvectoredexceptionhandler.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:errhandlingapi.AddVectoredExceptionHandler	AddVectoredExceptionHandler function (errhandlingapi.h)	Registers a vectored exception handler.	AddVectoredExceptionHandler AddVectoredExceptionHandler function _win32_addvectoredexceptionhandler base.addvectoredexceptionhandler errhandlingapi/AddVectoredExceptionHandler	base\addvectoredexceptionhandler.htm	Debug	0e956746-e6da-49d8-a534-753cb6755673	12/05/2018	AddVectoredExceptionHandler, AddVectoredExceptionHandler function, _win32_addvectoredexceptionhandler, base.addvectoredexceptionhandler, errhandlingapi/AddVectoredExceptionHandler	errhandlingapi.h	Windows.h	Windows	Windows XP [desktop apps only]	Windows Server 2003 [desktop apps only]										Kernel32.lib	Kernel32.dll		Windows			19H1	AddVectoredExceptionHandler errhandlingapi/AddVectoredExceptionHandler	c++	APIRef kbSyntax	DllExport	Kernel32.dll API-MS-Win-Core-errorhandling-l1-1-1.dll KernelBase.dll API-MS-Win-Core-errorhandling-l1-1-2.dll API-MS-Win-DownLevel-Kernel32-l1-1-0.dll MinKernelBase.dll API-MS-Win-Core-ErrorHandling-L1-1-3.dll	AddVectoredExceptionHandler

-description

Registers a vectored exception handler.

-parameters

-param First

The order in which the handler should be called. If the parameter is nonzero, the handler is the first handler to be called. If the parameter is zero, the handler is the last handler to be called.

-param Handler

A pointer to the handler to be called. For more information, see VectoredHandler.

-returns

If the function succeeds, the return value is a handle to the exception handler.

If the function fails, the return value is NULL.

-remarks

If the First parameter is nonzero, the handler is the first handler to be called until a subsequent call to AddVectoredExceptionHandler is used to specify a different handler as the first handler.

If the VectoredHandler parameter points to a function in a DLL and that DLL is unloaded, the handler is still registered. This can lead to application errors.

To unregister the handler, use the RemoveVectoredExceptionHandler function function.

To compile an application that uses this function, define the _WIN32_WINNT macro as 0x0500 or later. For more information, see Using the Windows Headers.

Examples

For an example, see Using a Vectored Exception Handler.

-see-also

AddVectoredContinueHandler function, RemoveVectoredExceptionHandler function, Vectored Exception Handling, VectoredHandler