WerRegisterCustomMetadata-Funktion (werapi.h)

Registriert App-spezifische Metadaten, die (in Form von Schlüssel-Wert-Zeichenfolgen) für den Windows-Fehlerberichterstattung -Fehlerbericht (WER) erfasst werden sollen.

Syntax

HRESULT WerRegisterCustomMetadata(
  PCWSTR key,
  PCWSTR value
);

Parameter

key

Die Zeichenfolge "key" für das metadatenelement, das registriert wird.

value

Die Wertzeichenfolge für das metadatenelement, das registriert wird.

Rückgabewert

Diese Funktion gibt S_OK bei Erfolg oder einen Fehlercode bei Fehler zurück, einschließlich der folgenden Fehlercodes.

Rückgabecode	Beschreibung
E_INVALIDARG	Zeichenfolgen waren NULL, die Schlüssellänge war größer als 64 Zeichen oder war ein ungültiger XML-Elementname, oder die Wertlänge war größer als 128 Zeichen oder enthaltene Zeichen, die keine ASCII-Druckzeichen waren.
E_OUTOFMEMORY	WER konnte keinen ausreichend großen Heap für die Daten zuordnen.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	Die maximale Anzahl registrierter Einträge (WER_MAX_REGISTERED_ENTRIES) oder die maximale Anzahl registrierter Metadaten (WER_MAX_REGISTERED_METADATA) wurde erreicht.
WER_E_INVALID_STATE	Der Prozessstatus ist ungültig. Der Prozess befindet sich beispielsweise im Anwendungswiederherstellungsmodus.

Hinweise

Mit dieser API können Apps ihre eigenen Telemetriedaten auf App-Ebene in Telemetrie auf Systemebene (WER) integrieren, indem Sie App-Metadaten Absturzberichten zuordnen, die ihren Prozessen entsprechen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1703 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	werapi.h
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

WerUnregisterCustomMetadata, Windows-Fehlerberichterstattung