Função ReportFault (errorrep.h)

  • Artigo

Habilita um aplicativo que executa seu próprio tratamento de exceção para relatar falhas à Microsoft. Embora você possa usar essa função para relatar falhas de aplicativo, recomendamos que os aplicativos não tratem erros fatais diretamente, mas, em vez disso, dependam da funcionalidade de relatório de falhas fornecida pelo sistema operacional.

Sintaxe

EFaultRepRetVal ReportFault(
  [in] LPEXCEPTION_POINTERS pep,
  [in] DWORD                dwOpt
);

Parâmetros

[in] pep

Um ponteiro para uma estrutura EXCEPTION_POINTERS.

[in] dwOpt

Esse parâmetro é reservado para uso do sistema e deve ser definido como zero.

Valor retornado

Essa função retorna um dos valores a seguir.

Código de retorno Descrição
frrvErr
 A função falhou, mas o cliente de relatório de erros foi iniciado.
frrvErrNoDW
 O cliente de relatório de erros não pôde ser iniciado. O sistema executará suas ações padrão, como exibir a caixa de diálogo de exceção padrão e iniciar o depurador.
frrvErrTimeout
 A função atingiu o tempo limite.
frrvLaunchDebugger
 A função foi bem-sucedida e o usuário iniciou o depurador.
frrvOk
 A função foi bem-sucedida.
frrvOkHeadless
 A função foi bem-sucedida e o cliente de relatório de erros foi iniciado no modo de relatório silencioso (nenhuma interface do usuário é usada).
frrvOkManifest
 A função foi bem-sucedida e o cliente de relatório de erros foi iniciado no modo de relatório de manifesto.
frrvOkQueued
 A função foi bem-sucedida e o relatório de falha foi enfileirado para relatórios posteriores.
 

Esses valores retornados indicam se o aplicativo de relatório foi iniciado com êxito. Um valor retornado bem-sucedido não indica necessariamente que a falha foi relatada com êxito.

Comentários

O resultado exato de chamar essa função depende de como o usuário ou o administrador do sistema configurou o sistema de relatório de erros.

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho errorrep.h
Biblioteca Faultrep.lib
DLL Faultrep.dll

Confira também

AddERExcludedApplication

EXCEPTION_POINTERS

Funções WER

Relatório de Erros do Windows