Macro GetExceptionInformation

Récupère une description indépendante de l’ordinateur d’une exception et des informations sur l’état de l’ordinateur qui existe pour le thread lorsque l’exception se produit. Cette fonction peut être appelée uniquement à partir de l’expression de filtre d’un gestionnaire d’exceptions.

Notes

Le compilateur d’optimisation Microsoft C/C++ interprète cette fonction comme un mot clé, et son utilisation en dehors de la syntaxe de gestion des exceptions appropriée génère une erreur du compilateur.

 

Syntaxe

LPEXCEPTION_POINTERS GetExceptionInformation(void);

Paramètres

Cette macro n’a aucun paramètre.

Valeur retournée

Pointeur vers une structure EXCEPTION_POINTERS qui contient des pointeurs vers les deux structures suivantes :

• EXCEPTION_RECORD structure qui contient une description de l’exception.
• STRUCTURE CONTEXT qui contient les informations d’état de l’ordinateur.

Notes

L’expression de filtre (à partir de laquelle la fonction est appelée) est évaluée si une exception se produit pendant l’exécution du bloc __try et détermine si le bloc __except est exécuté ou non.

L’expression de filtre peut appeler une fonction de filtre. La fonction de filtre ne peut pas appeler GetExceptionInformation. Toutefois, la valeur de retour de GetExceptionInformation peut être passée en tant que paramètre à une fonction de filtre.

Pour transmettre les informations EXCEPTION_POINTERS au bloc de gestionnaire d’exceptions, l’expression de filtre ou la fonction de filtre doit copier le pointeur ou les données dans le stockage sécurisé auquel le gestionnaire pourra accéder ultérieurement.

Dans le cas de gestionnaires imbriqués, chaque expression de filtre est évaluée jusqu’à ce qu’une expression soit évaluée comme EXCEPTION_EXECUTE_HANDLER ou EXCEPTION_CONTINUE_EXECUTION. Chaque expression de filtre peut appeler GetExceptionInformation pour obtenir des informations d’exception.

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]

Voir aussi

CONTEXTE

EXCEPTION_POINTERS

EXCEPTION_RECORD

GetExceptionCode

GetXStateFeaturesMask

Fonctions de gestion structurée des exceptions

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

Activer la prise en charge de Windows pour Intel AVX