Fonction WerRegisterFile (werapi.h)
Inscrit un fichier à collecter lorsque Rapport d'erreurs Windows crée un rapport d’erreurs.
Syntaxe
HRESULT WerRegisterFile(
[in] PCWSTR pwzFile,
[in] WER_REGISTER_FILE_TYPE regFileType,
[in] DWORD dwFlags
);
Paramètres
[in] pwzFile
Chemin d'accès complet au fichier. La longueur maximale de ce chemin est MAX_PATH caractères.
[in] regFileType
Type de fichier. Ce paramètre peut être l’une des valeurs suivantes du type d’énumération WER_REGISTER_FILE_TYPE .
| Valeur | Signification |
|---|---|
| WerRegFileTypeMax | |
| 3 | Valeur maximale pour le type d’énumération WER_REGISTER_FILE_TYPE . |
| WerRegFileTypeOther | |
| 2 | Tout autre type de fichier. |
| WerRegFileTypeUserDocument | |
| 1 | Document utilisé par l’application au moment de l’événement. Ce document est collecté uniquement si le serveur Watson le demande. |
[in] dwFlags
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 | Supprime automatiquement le fichier après son ajout au 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 les codes d’erreur suivants.
| Code de retour | Description |
|---|---|
| WER_E_INVALID_STATE | L’état du processus n’est pas valide. Par exemple, le processus est en mode de récupération d’application. |
| HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) | Le nombre de blocs de mémoire et de fichiers inscrits dépasse la limite. |
Remarques
Le fichier inscrit est ajouté au rapport uniquement lorsque des données supplémentaires sont demandées par le serveur.
Pour les incidents et les non-réponses, le système d’exploitation fournit automatiquement un rapport d’erreurs (vous n’avez pas besoin de fournir de code de rapport d’erreurs dans votre application). Si vous utilisez cette fonction pour inscrire un fichier, le système d’exploitation ajoute le fichier au rapport d’erreurs créé au moment d’un incident ou d’une non-réponse (ce fichier est ajouté en plus des fichiers déjà collectés par le système d’exploitation).
Pour la création de rapports d’événements génériques, l’application doit utiliser la fonction WerReportAddFile à la place. Sinon, l’appel de la fonction WerReportSubmit avec l’indicateur WER_SUBMIT_ADD_REGISTERED_DATA inclut les fichiers ajoutés par la fonction WerRegisterFile .
Pour supprimer le fichier de la liste, appelez la fonction WerUnregisterFile .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau | applications UWP] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau | applications UWP] |
| Plateforme cible | Windows |
| En-tête | werapi.h |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |