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 |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour