PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE fonction de rappel (werapi.h)

  • Article

Rapport d'erreurs Windows (WER) appelle cette fonction pour obtenir les paramètres de rapport qui décrivent de manière unique le problème.

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

Syntaxe

PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE PfnWerRuntimeExceptionEventSignature;

HRESULT PfnWerRuntimeExceptionEventSignature(
  [in]      PVOID pContext,
  [in]      const PWER_RUNTIME_EXCEPTION_INFORMATION pExceptionInformation,
  [in]      DWORD dwIndex,
  [out]     PWSTR pwszName,
  [in, out] PDWORD pchName,
  [out]     PWSTR pwszValue,
  [in, out] PDWORD pchValue
)
{...}

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.

[in] dwIndex

Index du paramètre de rapport. Les valeurs valides sont comprises entre 0 et 9. Le premier appel à cette fonction doit définir l’index sur 0, et chaque appel successif doit incrémenter la valeur d’index de manière séquentielle.

[out] pwszName

Mémoire tampon allouée à l’appelant que vous utilisez pour spécifier le nom du paramètre.

[in, out] pchName

Taille, en caractères, de la mémoire tampon pwszName . La taille inclut le caractère de fin null.

[out] pwszValue

Mémoire tampon allouée à l’appelant que vous utilisez pour spécifier la valeur du paramètre.

[in, out] pchValue

Taille, en caractères, de la mémoire tampon pwszValue . La taille inclut le caractère de fin null.

Valeur retournée

Retourne S_OK en cas de réussite. Si vous retournez d’autres codes d’échec, WER rétablit son comportement de rapport d’incident par défaut.

Remarques

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

Pour générer des rapports d’erreurs pour des problèmes spécifiques à l’application, l’application doit créer une brève description du problème à l’aide de quelques informations de base appelées paramètres de rapport. Les paramètres de rapport incluent des informations telles que le nom de l’application, la version de l’application, le nom du module, la version du module et le code d’erreur. La combinaison de ces paramètres de rapport décrit un problème unique.

WER appelle cette fonction de rappel uniquement si vous définissez le paramètre pbOwnershipClaimed de votre fonction de rappel OutOfProcessExceptionEventCallback sur TRUE. Le paramètre pdwSignatureCount de OutOfProcessExceptionEventCallback détermine le nombre de fois où WER appellera cette fonction de rappel.

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