Função WerRegisterFile (werapi.h)
Registra um arquivo a ser coletado quando Relatório de Erros do Windows (WER) cria um relatório de erros.
Sintaxe
HRESULT WerRegisterFile(
[in] PCWSTR pwzFile,
[in] WER_REGISTER_FILE_TYPE regFileType,
[in] DWORD dwFlags
);
Parâmetros
[in] pwzFile
O caminho completo para o arquivo. O comprimento máximo desse caminho é MAX_PATH caracteres.
[in] regFileType
O tipo de arquivo. Esse parâmetro pode ser um dos seguintes valores do tipo de enumeração WER_REGISTER_FILE_TYPE .
Valor | Significado |
---|---|
WerRegFileTypeMax | |
3 | O valor máximo para o tipo de enumeração WER_REGISTER_FILE_TYPE. |
WerRegFileTypeOther | |
2 | Qualquer outro tipo de arquivo. |
WerRegFileTypeUserDocument | |
1 | O documento em uso pelo aplicativo no momento do evento. Este documento só será coletado se o servidor Watson o solicitar. |
[in] dwFlags
Esse parâmetro pode usar um dos valores a seguir.
Valor | Significado |
---|---|
WER_FILE_ANONYMOUS_DATA | O arquivo não contém informações pessoais que podem ser usadas para identificar ou contatar o usuário. |
WER_FILE_DELETE_WHEN_DONE | Exclui automaticamente o arquivo depois que ele é adicionado ao relatório. |
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 |
---|---|
WER_E_INVALID_STATE | O estado do processo não é válido. Por exemplo, o processo está no modo de recuperação de aplicativo. |
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) | O número de arquivos e blocos de memória registrados excede o limite. |
Comentários
O arquivo registrado é adicionado ao relatório somente quando dados adicionais são solicitados pelo servidor.
Para falhas e não respostas, o sistema operacional fornece automaticamente relatórios de erros (você não precisa fornecer nenhum código de relatório de erros em seu aplicativo). Se você usar essa função para registrar um arquivo, o sistema operacional adicionará o arquivo ao relatório de erros criado no momento de uma falha ou não resposta (esse arquivo é adicionado além dos arquivos que o sistema operacional já coleta).
Para relatórios de eventos genéricos, o aplicativo precisa usar a função WerReportAddFile . Como alternativa, chamar a função WerReportSubmit com o sinalizador WER_SUBMIT_ADD_REGISTERED_DATA incluirá os arquivos que a função WerRegisterFile adicionou.
Para remover o arquivo da lista, chame a função WerUnregisterFile .
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
Servidor mínimo com suporte | Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
Plataforma de Destino | Windows |
Cabeçalho | werapi.h |
Biblioteca | Kernel32.lib |
DLL | Kernel32.dll |