PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE fonction de rappel (werapi.h)
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.
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
)
{...}
[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.
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.
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.
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 |
WerRegisterRuntimeExceptionModule, Rapport d'erreurs Windows