Funzione WerRegisterCustomMetadata (werapi.h)

Registra i metadati specifici dell'app da raccogliere (sotto forma di stringhe chiave/valore) per il report degli errori Segnalazione errori Windows (WER).

Sintassi

HRESULT WerRegisterCustomMetadata(
  PCWSTR key,
  PCWSTR value
);

Parametri

key

Stringa "key" per l'elemento di metadati da registrare.

value

Stringa di valore per l'elemento di metadati da registrare.

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo o un codice di errore in caso di errore, inclusi i codici di errore seguenti.

Codice restituito	Descrizione
E_INVALIDARG	Le stringhe erano NULL, la lunghezza della chiave era maggiore di 64 caratteri o era un nome di elemento xml non valido oppure la lunghezza del valore era maggiore di 128 caratteri o caratteri contenuti che non erano caratteri stampabili ASCII.
E_OUTOFMEMORY	WeR non è riuscito ad allocare un heap sufficientemente grande per i dati
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	È stato raggiunto il numero massimo di voci registrate (WER_MAX_REGISTERED_ENTRIES) o la quantità massima di metadati registrati (WER_MAX_REGISTERED_METADATA).
WER_E_INVALID_STATE	Lo stato del processo non è valido. Ad esempio, il processo è in modalità di ripristino dell'applicazione.

Commenti

Questa API consente alle app di integrare i propri dati di telemetria a livello di app con i dati di telemetria a livello di sistema associando i metadati dell'app ai report di arresto anomalo corrispondenti ai processi.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 versione 1703 [app desktop | App UWP]
Server minimo supportato	Windows Server 2016 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	werapi.h
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

WerUnregisterCustomMetadata, Segnalazione errori Windows