AddVectoredExceptionHandler, fonction (errhandlingapi.h)

Inscrit un gestionnaire d’exceptions vectorisées.

Syntaxe

PVOID AddVectoredExceptionHandler(
  ULONG                       First,
  PVECTORED_EXCEPTION_HANDLER Handler
);

Paramètres

First

Ordre dans lequel le gestionnaire doit être appelé. Si le paramètre est différent de zéro, le gestionnaire est le premier gestionnaire à être appelé. Si le paramètre est égal à zéro, le gestionnaire est le dernier gestionnaire à être appelé.

Handler

Pointeur vers le gestionnaire à appeler. Pour plus d’informations, consultez VectoredHandler.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle pour le gestionnaire d’exceptions.

Si la fonction échoue, la valeur de retour est NULL.

Remarques

Si le paramètre First est différent de zéro, le gestionnaire est le premier gestionnaire à être appelé jusqu’à ce qu’un appel suivant à AddVectoredExceptionHandler soit utilisé pour spécifier un gestionnaire différent comme premier gestionnaire.

Si le paramètre VectoredHandler pointe vers une fonction dans une DLL et que cette DLL est déchargée, le gestionnaire est toujours inscrit. Cela peut entraîner des erreurs d’application.

Pour annuler l’inscription du gestionnaire, utilisez la fonction RemoveVectoredExceptionHandler .

Pour compiler une application qui utilise cette fonction, définissez la macro _WIN32_WINNT comme 0x0500 ou version ultérieure. Pour plus d’informations, consultez Utilisation des en-têtes Windows.

Exemples

Pour obtenir un exemple, consultez Utilisation d’un gestionnaire d’exceptions vectorielles.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	errhandlingapi.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

AddVectoredContinueHandler, fonction RemoveVectoredExceptionHandler, gestion des exceptions vectorielles, VectoredHandler