Fonction RaiseFailFastException (errhandlingapi.h)

Article
02/27/2024

Déclenche une exception qui contourne tous les gestionnaires d’exceptions (basés sur des images ou des vecteurs). Le déclenchement de cette exception met fin à l’application et appelle Rapport d'erreurs Windows, si Rapport d'erreurs Windows est activé.

Syntaxe

void RaiseFailFastException(
  [in, optional] PEXCEPTION_RECORD pExceptionRecord,
  [in, optional] PCONTEXT          pContextRecord,
  [in]           DWORD             dwFlags
);

Paramètres

[in, optional] pExceptionRecord

Pointeur vers une structure de EXCEPTION_RECORD qui contient les informations d’exception. Vous devez spécifier les membres ExceptionAddress et ExceptionCode .

Si ce paramètre a la valeur NULL, la fonction crée un enregistrement d’exception et définit le membre ExceptionCode sur STATUS_FAIL_FAST_EXCEPTION. La fonction définit également le membre ExceptionAddress si le paramètre dwFlags contient l’indicateur FAIL_FAST_GENERATE_EXCEPTION_ADDRESS.

[in, optional] pContextRecord

Pointeur vers une structure CONTEXT qui contient les informations de contexte. Si la valeur est NULL, cette fonction génère le contexte (toutefois, le contexte ne correspond pas exactement au contexte de l’appelant).

[in] dwFlags

Vous pouvez spécifier zéro ou l’indicateur suivant qui contrôle le comportement de cette fonction :

Valeur	Signification
FAIL_FAST_GENERATE_EXCEPTION_ADDRESS 0x1	Amène RaiseFailFastException à définir l’ExceptionAddress de EXCEPTION_RECORD sur l’adresse de retour de cette fonction (l’instruction suivante dans l’appelant après l’appel à RaiseFailFastException). Cette fonction définit l’adresse d’exception uniquement si ExceptionAddress n’a pas la valeur NULL.

Valeur de retour

None

Remarques

En règle générale, vous appelez cette fonction si votre application est dans un état incorrect et que vous souhaitez arrêter l’application immédiatement et créer un rapport d’erreurs Windows.

Si le service WER est désactivé ou ne peut pas être démarré ou si aucun débogueur n’est attaché au processus, le processus est arrêté.

Cette fonction déclenche une exception de deuxième chance. Si le débogage JIT est activé, un débogueur s’attache au processus.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	errhandlingapi.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

Environment.FailFast

Partager via