Fonction UnhandledExceptionFilter (errhandlingapi.h)

Article
08/23/2023

Fonction définie par l’application qui transmet des exceptions non gérées au débogueur, si le processus est en cours de débogage. Sinon, il affiche éventuellement une boîte de message Erreur d’application et entraîne l’exécution du gestionnaire d’exceptions. Cette fonction peut être appelée uniquement à partir de l’expression de filtre d’un gestionnaire d’exceptions.

Syntaxe

LONG UnhandledExceptionFilter(
  [in] _EXCEPTION_POINTERS *ExceptionInfo
);

Paramètres

[in] ExceptionInfo

Pointeur vers une structure de EXCEPTION_POINTERS qui spécifie une description de l’exception et du contexte de processeur au moment de l’exception. Ce pointeur est la valeur de retour d’un appel à la fonction GetExceptionInformation .

Valeur retournée

La fonction retourne l’une des valeurs suivantes.

Code/valeur de retour	Description
EXCEPTION_CONTINUE_SEARCH 0x0	Le processus étant en cours de débogage, l’exception doit être passée (comme deuxième chance) au débogueur de l’application.
EXCEPTION_EXECUTE_HANDLER 0x1	Si l’indicateur SEM_NOGPFAULTERRORBOX a été spécifié dans un appel précédent à SetErrorMode, aucune boîte de message Erreur d’application ne s’affiche. La fonction retourne le contrôle au gestionnaire d’exceptions, qui est libre d’effectuer toute action appropriée.

Notes

Si le processus n’est pas débogué, la fonction affiche une boîte de message Erreur d’application , en fonction du mode d’erreur actuel. Le comportement par défaut consiste à afficher la boîte de dialogue, mais cela peut être désactivé en spécifiant SEM_NOGPFAULTERRORBOX dans un appel à la fonction SetErrorMode .

Le système utilise UnhandledExceptionFilter en interne pour gérer les exceptions qui se produisent lors de la création du processus et du thread.

Spécifications


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