AddVectoredExceptionHandler-Funktion (errhandlingapi.h)

Registriert einen vektoriellen Ausnahmehandler.

Syntax

PVOID AddVectoredExceptionHandler(
  ULONG                       First,
  PVECTORED_EXCEPTION_HANDLER Handler
);

Parameter

First

Die Reihenfolge, in der der Handler aufgerufen werden soll. Wenn der Parameter ungleich null ist, ist der Handler der erste Handler, der aufgerufen wird. Wenn der Parameter null ist, ist der Handler der letzte aufgerufene Handler.

Handler

Ein Zeiger auf den aufgerufenen Handler. Weitere Informationen finden Sie unter VectoredHandler.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für den Ausnahmehandler.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL.

Hinweise

Wenn der First-Parameter ungleich null ist, ist der Handler der erste Handler, der aufgerufen wird, bis ein nachfolgender Aufruf von AddVectoredExceptionHandler verwendet wird, um einen anderen Handler als ersten Handler anzugeben.

Wenn der VectoredHandler-Parameter auf eine Funktion in einer DLL zeigt und diese DLL entladen wird, ist der Handler weiterhin registriert. Dies kann zu Anwendungsfehlern führen.

Um die Registrierung des Handlers aufzuheben, verwenden Sie die Funktion RemoveVectoredExceptionHandler .

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie das makro _WIN32_WINNT als 0x0500 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.

Beispiele

Ein Beispiel finden Sie unter Verwenden eines Vektor-Ausnahmehandlers.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	errhandlingapi.h (Windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

AddVectoredContinueHandler-Funktion, RemoveVectoredExceptionHandler-Funktion, Vektored Exception Handling, VectoredHandler