PFN_WER_RUNTIME_EXCEPTION_EVENT fonction de rappel (werapi.h)

Article
07/27/2023

Rapport d'erreurs Windows (WER) appelle cette fonction pour déterminer si le gestionnaire d’exceptions revendique le blocage.

Le type PFN_WER_RUNTIME_EXCEPTION_EVENT définit un pointeur vers cette fonction de rappel. Vous devez utiliser « OutOfProcessExceptionEventCallback » comme nom de la fonction de rappel.

Syntaxe

PFN_WER_RUNTIME_EXCEPTION_EVENT PfnWerRuntimeExceptionEvent;

HRESULT PfnWerRuntimeExceptionEvent(
  [in]      PVOID pContext,
  [in]      const PWER_RUNTIME_EXCEPTION_INFORMATION pExceptionInformation,
  [out]     BOOL *pbOwnershipClaimed,
  [out]     PWSTR pwszEventName,
  [in, out] PDWORD pchSize,
  [out]     PDWORD pdwSignatureCount
)
{...}

Paramètres

[in] pContext

Pointeur vers des informations de contexte arbitraires que vous avez spécifiées lorsque vous avez appelé la fonction WerRegisterRuntimeExceptionModule pour inscrire le gestionnaire d’exceptions.

[in] pExceptionInformation

Structure WER_RUNTIME_EXCEPTION_INFORMATION qui contient les informations d’exception. Utilisez les informations pour déterminer si vous souhaitez réclamer l’incident.

[out] pbOwnershipClaimed

Défini sur TRUE si le gestionnaire d’exceptions revendique ce blocage ; sinon, FALSE. Si vous définissez ce paramètre sur FALSE, ne définissez pas le reste des paramètres de sortie.

[out] pwszEventName

Mémoire tampon allouée à l’appelant que vous utilisez pour spécifier le nom d’événement utilisé pour identifier cet incident.

[in, out] pchSize

Taille, en caractères, de la mémoire tampon pwszEventName . La mémoire tampon est limitée à MAX_PATH caractères. La taille inclut le caractère de fin null.

[out] pdwSignatureCount

Nombre de paramètres de rapport que vous allez fournir. La plage de valeurs valide est de 1 à 10. Si vous spécifiez une valeur supérieure à 10, WER ignore la valeur et collecte uniquement les 10 premiers paramètres. Si vous spécifiez zéro, le processus de création de rapports sera indéterminé.

Cette valeur détermine le nombre de fois où WER appelle votre fonction OutOfProcessExceptionEventSignatureCallback .

Valeur retournée

Retournez S_OK, même si le gestionnaire d’exceptions ne revendique pas ce blocage. Si vous retournez d’autres codes d’échec, WER rétablit son comportement de signalement d’incidents par défaut si aucun autre gestionnaire n’est inscrit.

Remarques

Vous devez implémenter cette fonction dans votre DLL de gestionnaire d’exceptions.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	werapi.h

Voir aussi

WerRegisterRuntimeExceptionModule, Rapport d'erreurs Windows

Partager via