Função WerReportCreate (werapi.h)

  • Artigo

Cria um relatório de Relatório de Erros do Windows (WER) que descreve um evento de aplicativo.

Sintaxe

HRESULT WerReportCreate(
  [in]           PCWSTR                  pwzEventType,
  [in]           WER_REPORT_TYPE         repType,
  [in, optional] PWER_REPORT_INFORMATION pReportInformation,
  [out]          HREPORT                 *phReportHandle
);

Parâmetros

[in] pwzEventType

Um ponteiro para uma cadeia de caracteres Unicode que especifica o nome do evento.

[in] repType

O tipo de relatório. Esse parâmetro pode ser um dos seguintes valores do tipo de enumeração WER_REPORT_TYPE .

Valor Significado
WerReportApplicationCrash
2		 Ocorreu um erro que fez com que o aplicativo parasse de ser executado.
WerReportApplicationHang
3		 Ocorreu um erro que fez com que o aplicativo parasse de responder.
WerReportInvalid
5		 Ocorreu um erro que chamou um retorno que não é válido.
WerReportKernel
4		 Ocorreu um erro no kernel.
WerReportCritical
1		 Ocorreu um erro crítico, como uma falha ou não resposta. Por padrão, os processos que experimentam um erro crítico são encerrados ou reiniciados.
WerReportNonCritical
0		 Ocorreu um erro que não é crítico. Esse tipo de relatório não mostra nenhuma interface do usuário; o relatório é enfileirado silenciosamente. Em seguida, ele poderá ser enviado silenciosamente para o servidor em segundo plano se o consentimento adequado do usuário estiver disponível.

[in, optional] pReportInformation

Um ponteiro para uma estrutura WER_REPORT_INFORMATION que especifica informações para o relatório.

[out] phReportHandle

Um identificador para o relatório. Se a função falhar, esse identificador será NULL.

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 as seguintes funções para especificar informações adicionais a serem enviadas:

Para enviar as informações, chame a função WerReportSubmit . Quando terminar de usar o identificador de relatório, chame a função WerReportCloseHandle .

Os aplicativos também podem indicar que gostariam da oportunidade de recuperar dados ou reiniciar em caso de falha. Para obter mais informações, consulte Recuperação e reinicialização do aplicativo.

Para exibir os relatórios enviados pelo seu aplicativo, acesse Windows Quality Online Services.

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

Recuperação e reinicialização do aplicativo, WER_REPORT_INFORMATION, WerReportCloseHandle, WerReportSubmitRelatório de Erros do Windows