Função UnhandledExceptionFilter (errhandlingapi.h)

Artigo
08/23/2023

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