Partilhar via

Função RaiseFailFastException (errhandlingapi.h)

  • Artigo

Gera uma exceção que ignora todos os manipuladores de exceção (baseado em quadro ou vetor). Gerar essa exceção encerrará o aplicativo e invocará Relatório de Erros do Windows, se Relatório de Erros do Windows estiver habilitado.

Sintaxe

void RaiseFailFastException(
  [in, optional] PEXCEPTION_RECORD pExceptionRecord,
  [in, optional] PCONTEXT          pContextRecord,
  [in]           DWORD             dwFlags
);

Parâmetros

[in, optional] pExceptionRecord

Um ponteiro para uma estrutura EXCEPTION_RECORD que contém as informações de exceção. Você deve especificar os membros ExceptionAddress e ExceptionCode .

Se esse parâmetro for NULL, a função criará um registro de exceção e definirá o membro ExceptionCode como STATUS_FAIL_FAST_EXCEPTION. A função também definirá o membro ExceptionAddress se o parâmetro dwFlags contiver o sinalizador FAIL_FAST_GENERATE_EXCEPTION_ADDRESS.

[in, optional] pContextRecord

Um ponteiro para uma estrutura CONTEXT que contém as informações de contexto. Se NULL, essa função gerará o contexto (no entanto, o contexto não corresponderá exatamente ao contexto do chamador).

[in] dwFlags

Você pode especificar zero ou o seguinte sinalizador que controla o comportamento dessa função:

Valor Significado
FAIL_FAST_GENERATE_EXCEPTION_ADDRESS
0x1
 Faz com que RaiseFailFastException defina ExceptionAddress de EXCEPTION_RECORD para o endereço de retorno dessa função (a próxima instrução no chamador após a chamada para RaiseFailFastException). Essa função definirá o endereço de exceção somente se ExceptionAddress não for NULL.

Retornar valor

Nenhum

Comentários

Normalmente, você chama essa função se o aplicativo está em um estado inválido e deseja encerrar o aplicativo imediatamente e criar um Relatório de Erros do Windows.

Se o serviço WER estiver desabilitado ou não puder ser iniciado ou não houver nenhum depurador anexado ao processo, o processo será encerrado.

Essa função gera uma segunda exceção de chance. Se a depuração JIT estiver habilitada, um depurador será anexado ao processo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho errhandlingapi.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

Environment.FailFast