Fonction RaiseFailFastException (errhandlingapi.h)
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 |
---|---|
|
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour