WerReportAddFile, fonction (werapi.h)

  • Article

Ajoute un fichier au rapport Rapport d'erreurs Windows (WER) spécifié.

Syntaxe

HRESULT WerReportAddFile(
  [in] HREPORT       hReportHandle,
  [in] PCWSTR        pwzPath,
  [in] WER_FILE_TYPE repFileType,
  [in] DWORD         dwFileFlags
);

Paramètres

[in] hReportHandle

Handle du rapport. Ce handle est retourné par la fonction WerReportCreate .

[in] pwzPath

Pointeur vers une chaîne Unicode qui contient le chemin complet du fichier à ajouter. Ce chemin d’accès peut utiliser des variables d’environnement. La longueur maximale de ce chemin est MAX_PATH caractères.

[in] repFileType

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

Valeur Signification
WerFileTypeHeapdump Minidump étendu qui contient des données supplémentaires telles que la mémoire de processus.
WerFileTypeMicrodump Minidump limité qui contient uniquement une trace de pile.
WerFileTypeMinidump Un fichier minidump.
WerFileTypeOther Tout autre type de fichier. Ce fichier est toujours ajouté à la cabine (mais uniquement si le serveur demande un cab).
WerFileTypeUserDocument Document utilisé par l’application au moment de l’événement. Le document est ajouté uniquement si le serveur demande ce type de document.

[in] dwFileFlags

Ce paramètre peut prendre une ou plusieurs des valeurs suivantes.

Valeur Signification
WER_FILE_ANONYMOUS_DATA Le fichier ne contient pas d’informations personnelles qui pourraient être utilisées pour identifier ou contacter l’utilisateur.
WER_FILE_DELETE_WHEN_DONE Supprimez automatiquement le fichier après l’envoi du rapport.

Valeur retournée

Cette fonction retourne S_OK en cas de réussite ou un code d’erreur en cas d’échec, y compris le code d’erreur suivant.

Code de retour Description
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) Le fichier spécifié n'existe pas.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) Le fichier spécifié est un document utilisateur et est stocké sur un système de fichiers chiffré ; cette combinaison n’est pas prise en charge.

Remarques

Bien que cette fonction puisse également être utilisée pour ajouter des vidages mémoire (à l’aide d’indicateurs spécifiques) au rapport d’erreurs, la fonction préférée à utiliser pour ajouter des vidages de mémoire est WerReportAddDump. Vous devez utiliser cette fonction uniquement si vous souhaitez collecter le vidage vous-même, puis l’ajouter au rapport.

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

WerReportCreate, Rapport d'erreurs Windows