Fonction RoFailFastWithErrorContext (roerrorapi.h)

Déclenche une exception non continuable dans le processus actuel.

Syntaxe

void RoFailFastWithErrorContext(
  [in] HRESULT hrError
);

Paramètres

[in] hrError

HRESULT associé à l’erreur actuelle. L’exception est levée pour n’importe quelle valeur de hrError.

Valeur de retour

None

Remarques

La fonction RoFailFastWithErrorContext lève une exception non continuable dans le processus actuel lorsqu’un échec non géré est rencontré, ce qui empêche le processus de poursuivre l’exécution dans un état non défini.

Appelez la fonction RoFailFastWithErrorContext lorsqu’une défaillance se produit dans un délégué d’achèvement pour une opération asynchrone terminée, ou lorsqu’un échec se produit dans un gestionnaire d’événements lorsqu’un événement est déclenché.

Le processus qui appelle RoFailFastWithErrorContext se termine par un appel à RaiseFailFastException. La fonction ne valide pas les paramètres et déclenche une exception pour toute valeur des entrées.

Appelez la fonction RoCaptureErrorContext pour enregistrer un objet IRestrictedErrorInfo associé au thread actuel. La fonction RoFailFastWithErrorContext utilise ces informations contextuelles pour signaler la pile des appels d’erreurs au service Rapport d'erreurs Windows (WER), si elle est activée.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	roerrorapi.h
Bibliothèque	RuntimeObject.lib
DLL	ComBase.dll

Voir aussi

IRestrictedErrorInfo

RaiseFailFastException

RoCaptureErrorContext