WerReportAddFile, fonction (werapi.h)
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 |