Compartilhar via

Função WerRegisterFile (werapi.h)

  • Artigo

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

Confira também

WerUnregisterFile, Relatório de Erros do Windows