WerRegisterCustomMetadata, fonction (werapi.h)
Inscrit les métadonnées spécifiques à l’application à collecter (sous la forme de chaînes de clé/valeur) pour le rapport d’erreurs Rapport d'erreurs Windows (WER).
Syntaxe
HRESULT WerRegisterCustomMetadata(
PCWSTR key,
PCWSTR value
);
Paramètres
key
Chaîne « key » pour l’élément de métadonnées en cours d’inscription.
value
Chaîne de valeur pour l’élément de métadonnées en cours d’inscription.
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 |
|---|---|
| E_INVALIDARG | Les chaînes étaient NULL, la longueur de la clé était supérieure à 64 caractères ou était un nom d’élément xml non valide, ou la longueur de la valeur était supérieure à 128 caractères ou contenait des caractères qui n’étaient pas des caractères imprimables ASCII. |
| E_OUTOFMEMORY | WER n’a pas pu allouer un tas suffisamment grand pour les données |
| HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) | Le nombre maximal d’entrées enregistrées (WER_MAX_REGISTERED_ENTRIES) ou la quantité maximale de métadonnées inscrites (WER_MAX_REGISTERED_METADATA) a été atteint. |
| 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. |
Remarques
Cette API permet aux applications d’intégrer leurs propres données de télémétrie au niveau de l’application à la télémétrie au niveau du système (WER) en associant des métadonnées d’application à des rapports d’incident correspondant à leurs processus.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10, version 1703 [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 | Kernel32.dll |