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

Voir aussi

WerUnregisterCustomMetadata, Rapport d'erreurs Windows