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 |