Função WerReportAddFile (werapi.h)

  • Artigo

Adiciona um arquivo ao relatório de Relatório de Erros do Windows (WER) especificado.

Sintaxe

HRESULT WerReportAddFile(
  [in] HREPORT       hReportHandle,
  [in] PCWSTR        pwzPath,
  [in] WER_FILE_TYPE repFileType,
  [in] DWORD         dwFileFlags
);

Parâmetros

[in] hReportHandle

Um identificador para o relatório. Esse identificador é retornado pela função WerReportCreate .

[in] pwzPath

Um ponteiro para uma cadeia de caracteres Unicode que contém o caminho completo para o arquivo a ser adicionado. Esse caminho pode usar variáveis de ambiente. O comprimento máximo desse caminho é MAX_PATH caracteres.

[in] repFileType

O tipo de arquivo. Esse parâmetro pode ser um dos seguintes valores do tipo de enumeração WER_FILE_TYPE .

Valor Significado
WerFileTypeHeapdump Um minidump estendido que contém dados adicionais, como a memória do processo.
WerFileTypeMicrodump Um minidump limitado que contém apenas um rastreamento de pilha.
WerFileTypeMinidump Um arquivo de minidump.
WerFileTypeOther Qualquer outro tipo de arquivo. Esse arquivo sempre será adicionado à cabine (mas somente se o servidor solicitar um táxi).
WerFileTypeUserDocument O documento em uso pelo aplicativo no momento do evento. O documento será adicionado somente se o servidor solicitar esse tipo de documento.

[in] dwFileFlags

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 Exclua automaticamente o arquivo após o envio do relatório.

Retornar valor

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

Código de retorno Descrição
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) O arquivo especificado não existe.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) O arquivo especificado é um documento do usuário e é armazenado em um sistema de arquivos criptografado; não há suporte para essa combinação.

Comentários

Embora essa função também possa ser usada para adicionar despejos de memória (usando sinalizadores específicos) ao relatório de erros, a função preferida a ser usada para adicionar despejos de memória é WerReportAddDump. Você deve usar essa função somente se quiser coletar o despejo por conta própria e, em seguida, adicioná-lo ao relatório.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho werapi.h
Biblioteca Wer.lib
DLL Wer.dll

Confira também

WerReportCreate, Relatório de Erros do Windows