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 |