Função WerReportAddDump (werapi.h)

  • Artigo

Adiciona um despejo do tipo especificado ao relatório wer (Relatório de Erros do Windows) especificado.

Sintaxe

HRESULT WerReportAddDump(
  [in]           HREPORT                    hReportHandle,
  [in]           HANDLE                     hProcess,
  [in, optional] HANDLE                     hThread,
  [in]           WER_DUMP_TYPE              dumpType,
  [in, optional] PWER_EXCEPTION_INFORMATION pExceptionParam,
  [in, optional] PWER_DUMP_CUSTOM_OPTIONS   pDumpCustomOptions,
  [in]           DWORD                      dwFlags
);

Parâmetros

[in] hReportHandle

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

[in] hProcess

Um identificador para o processo para o qual o relatório está sendo gerado. Esse identificador deve ter os direitos de acesso STANDARD_RIGHTS_READ e PROCESS_QUERY_INFORMATION.

[in, optional] hThread

Um identificador para o thread do hProcess para o qual o relatório está sendo gerado. Se dumpType for WerDumpTypeMicro, esse parâmetro será necessário. Para outros tipos de despejo, esse parâmetro pode ser NULL.

[in] dumpType

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

Valor Significado
WerDumpTypeHeapDump
 Um minidespejo estendido que contém dados adicionais, como a memória do processo.

Esse tipo é equivalente à criação de um minidespejo com as seguintes opções:

  • MiniDumpWithDataSegs
  • MiniDumpWithProcessThreadData
  • MiniDumpWithHandleData
  • MiniDumpWithPrivateReadWriteMemory
  • MiniDumpWithUnloadedModules
  • MiniDumpWithFullMemoryInfo
  • MiniDumpWithThreadInfo (Windows 7 e posterior)
  • MiniDumpWithTokenInformation (Windows 7 e posterior)
  • MiniDumpWithPrivateWriteCopyMemory (Windows 7 e posterior)
WerDumpTypeMicroDump
 Um minidespejo limitado que contém apenas um rastreamento de pilha.

Esse tipo é equivalente à criação de um minidespejo com as seguintes opções:

  • MiniDumpWithDataSegs
  • MiniDumpWithUnloadedModules
  • MiniDumpWithProcessThreadData
  • MiniDumpWithoutOptionalData
WerDumpTypeMiniDump
 Um minidespejo.

Esse tipo é equivalente à criação de um minidespejo com as seguintes opções:

  • MiniDumpWithDataSegs
  • MiniDumpWithUnloadedModules
  • MiniDumpWithProcessThreadData
  • MiniDumpWithTokenInformation (Windows 7 e posterior)

[in, optional] pExceptionParam

Um ponteiro para uma estrutura WER_EXCEPTION_INFORMATION que especifica informações de exceção.

[in, optional] pDumpCustomOptions

Um ponteiro para uma estrutura WER_DUMP_CUSTOM_OPTIONS que especifica opções de minidespejo personalizadas. Se esse parâmetro for NULL, as informações de minidespejo padrão serão coletadas.

[in] dwFlags

Esse parâmetro pode ser 0 ou o valor a seguir.

Valor Significado
WER_DUMP_NOHEAP_ONQUEUE
 Se o relatório estiver sendo enfileirado, não inclua um despejo de heap. O uso desse sinalizador economiza espaço em disco.

Retornar valor

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

Comentários

Use essa função somente para relatórios genéricos— ela não tem nenhum efeito sobre a falha do sistema operacional ou relatórios sem resposta.

Se o servidor solicitar um mini despejo e você especificar WerDumpTypeHeapDump para o parâmetro dumpType , o WER não enviará o despejo de heap para o servidor Watson. No entanto, se o servidor solicitar um despejo de heap e o dumpType for WerDumpTypeMiniDump, o WER enviará o mini despejo para o servidor. Portanto, é recomendável que você defina dumpType como WerDumpTypeMiniDump.

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

Arquivos de minidespejo, WER_DUMP_CUSTOM_OPTIONS, WER_EXCEPTION_INFORMATION, WerReportCreateRelatório de Erros do Windows