Função WerRegisterCustomMetadata (werapi.h)

Registra metadados específicos do aplicativo a serem coletados (na forma de cadeias de caracteres de chave/valor) para o relatório de erros de Relatório de Erros do Windows (WER).

Sintaxe

HRESULT WerRegisterCustomMetadata(
  PCWSTR key,
  PCWSTR value
);

Parâmetros

key

A cadeia de caracteres "key" para o elemento de metadados que está sendo registrado.

value

A cadeia de caracteres de valor para o elemento de metadados que está sendo registrado.

Retornar valor

Essa função retorna S_OK em caso de êxito ou um código de erro em caso de falha, incluindo os códigos de erro a seguir.

Código de retorno	Descrição
E_INVALIDARG	As cadeias de caracteres eram NULL, o comprimento da chave era maior que 64 caracteres ou era um nome de elemento xml inválido ou o comprimento do valor era maior que 128 caracteres ou caracteres contidos que não eram caracteres imprimíveis ASCII.
E_OUTOFMEMORY	O WER não pôde alocar um heap grande o suficiente para os dados
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	O número máximo de entradas registradas (WER_MAX_REGISTERED_ENTRIES) ou a quantidade máxima de metadados registrados (WER_MAX_REGISTERED_METADATA) foi atingido.
WER_E_INVALID_STATE	O estado do processo não é válido. Por exemplo, o processo está no modo de recuperação de aplicativo.

Comentários

Essa API permite que os aplicativos integrem sua própria telemetria no nível do aplicativo ao WER (telemetria no nível do sistema) associando metadados de aplicativo a relatórios de falha correspondentes aos seus processos.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 1703 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2016 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	werapi.h
Biblioteca	Kernel32.lib
DLL	Kernel32.dll

Confira também

WerUnregisterCustomMetadata, Relatório de Erros do Windows