Compartilhar via


Função UnhandledExceptionFilter (errhandlingapi.h)

Uma função definida pelo aplicativo que passa exceções sem tratamento para o depurador, se o processo estiver sendo depurado. Caso contrário, ele exibirá opcionalmente uma caixa de mensagem De erro do aplicativo e fará com que o manipulador de exceção seja executado. Essa função só pode ser chamada a partir da expressão de filtro de um manipulador de exceção.

Sintaxe

LONG UnhandledExceptionFilter(
  [in] _EXCEPTION_POINTERS *ExceptionInfo
);

Parâmetros

[in] ExceptionInfo

Um ponteiro para uma estrutura EXCEPTION_POINTERS que especifica uma descrição da exceção e do contexto do processador no momento da exceção. Esse ponteiro é o valor retornado de uma chamada para a função GetExceptionInformation .

Valor retornado

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

Valor/código retornado Descrição
EXCEPTION_CONTINUE_SEARCH
0x0
O processo está sendo depurado, portanto, a exceção deve ser passada (como segunda chance) para o depurador do aplicativo.
EXCEPTION_EXECUTE_HANDLER
0x1
Se o sinalizador SEM_NOGPFAULTERRORBOX tiver sido especificado em uma chamada anterior para SetErrorMode, nenhuma caixa de mensagem de Erro do Aplicativo será exibida. A função retorna o controle para o manipulador de exceção, que é livre para executar qualquer ação apropriada.

Comentários

Se o processo não estiver sendo depurado, a função exibirá uma caixa de mensagem De erro do aplicativo , dependendo do modo de erro atual. O comportamento padrão é exibir a caixa de diálogo, mas isso pode ser desabilitado especificando SEM_NOGPFAULTERRORBOX em uma chamada para a função SetErrorMode .

O sistema usa UnhandledExceptionFilter internamente para lidar com exceções que ocorrem durante a criação de processos e threads.

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 errhandlingapi.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

EXCEPTION_POINTERS

GetExceptionInformation

SetErrorMode

SetUnhandledExceptionFilter

Funções do tratamento de exceções estruturado

Visão geral da manipulação de exceção estruturada