Fonction WerReportCreate (werapi.h)

  • Article

Crée un rapport Rapport d'erreurs Windows (WER) qui décrit un événement d’application.

Syntaxe

HRESULT WerReportCreate(
  [in]           PCWSTR                  pwzEventType,
  [in]           WER_REPORT_TYPE         repType,
  [in, optional] PWER_REPORT_INFORMATION pReportInformation,
  [out]          HREPORT                 *phReportHandle
);

Paramètres

[in] pwzEventType

Pointeur vers une chaîne Unicode qui spécifie le nom de l’événement.

[in] repType

Type de rapport. Ce paramètre peut être l’une des valeurs suivantes du type d’énumération WER_REPORT_TYPE .

Valeur Signification
WerReportApplicationCrash
2		 Une erreur qui a provoqué l’arrêt de l’exécution de l’application s’est produite.
WerReportApplicationHang
3		 Une erreur qui a provoqué l’arrêt de la réponse de l’application s’est produite.
WerReportInvalid
5		 Une erreur qui a appelé un retour non valide s’est produite.
WerReportKernel
4		 Une erreur s’est produite dans le noyau.
WerReportCritical
1		 Une erreur critique, telle qu’un incident ou une non-réponse, s’est produite. Par défaut, les processus qui rencontrent une erreur critique sont arrêtés ou redémarrés.
WerReportNonCritical
0		 Une erreur qui n’est pas critique s’est produite. Ce type de rapport n’affiche aucune interface utilisateur ; le rapport est mis en file d’attente en mode silencieux. Il peut ensuite être envoyé en mode silencieux au serveur en arrière-plan si le consentement de l’utilisateur est suffisant.

[in, optional] pReportInformation

Pointeur vers une structure de WER_REPORT_INFORMATION qui spécifie des informations pour le rapport.

[out] phReportHandle

Handle du rapport. Si la fonction échoue, ce handle est NULL.

Valeur retournée

Cette fonction retourne S_OK en cas de réussite ou un code d’erreur en cas d’échec.

Remarques

Utilisez les fonctions suivantes pour spécifier des informations supplémentaires à envoyer :

Pour envoyer les informations, appelez la fonction WerReportSubmit . Une fois le handle de rapport terminé, appelez la fonction WerReportCloseHandle .

Les applications peuvent également indiquer qu’elles aimeraient avoir la possibilité de récupérer des données ou de redémarrer en cas d’échec. Pour plus d’informations, consultez Récupération et redémarrage des applications.

Pour afficher les rapports envoyés par votre application, accédez à Windows Quality Online Services.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête werapi.h
Bibliothèque Wer.lib
DLL Wer.dll

Voir aussi

Récupération et redémarraged’application, WER_REPORT_INFORMATION, WerReportCloseHandle, WerReportSubmit, Rapport d'erreurs Windows