WerRegisterAppLocalDump, fonction (werapi.h)
Inscrit un chemin d’accès (relatif au LocalFolder de l’application empaquetée) où une copie doit être enregistrée du vidage de la mémoire de diagnostic que Rapport d'erreurs Windows (WER) collecte quand l’un des processus de l’application cesse de répondre.
Syntaxe
HRESULT WerRegisterAppLocalDump(
[in] PCWSTR localAppDataRelativePath
);
Paramètres
[in] localAppDataRelativePath
Chemin relatif au magasin d’applications local de l’application appelante. C’est là qu’une copie de l’image mémoire de diagnostic collectée par WER est enregistrée quand l’un des processus de l’application cesse de répondre. La longueur maximale de ce chemin relatif en caractères est WER_MAX_LOCAL_DUMP_SUBPATH_LENGTH, qui a une valeur de 64. Cette longueur maximale inclut le caractère d’arrêt Null.
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 | Le processus ne peut pas stocker le vidage de la mémoire, ou WER ne peut pas créer d’emplacement pour stocker le vidage de la mémoire. |
| E_INVALIDARG | Le paramètre localAppDataRelativePath est NULL ou contient plus de 64 caractères. |
Remarques
Une application empaquetée appelle WerRegisterAppLocalDump au lancement de l’application pour demander une copie du vidage de la mémoire de diagnostic que WER collecte si ou quand l’un des processus de l’application cesse de répondre.
WER ne gère pas le stockage à l’emplacement spécifié par le chemin d’accès relatif ni le nombre de vidages de mémoire collectés pour l’application.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10, version 1709 [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows Server 2016 [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | werapi.h |
| Bibliothèque | Kernel32.lib |
| DLL | KernelBase.dll |
Voir aussi
Fonction WerUnregisterAppLocalDump, Rapport d'erreurs Windows