Partager via


Fonction UnhandledExceptionFilter (errhandlingapi.h)

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

Voir aussi

EXCEPTION_POINTERS

GetExceptionInformation

SetErrorMode

SetUnhandledExceptionFilter

Fonctions de gestion structurée des exceptions

Vue d’ensemble de la gestion structurée des exceptions