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 |
|---|---|
|
O processo está sendo depurado, portanto, a exceção deve ser passada (como segunda chance) para o depurador do aplicativo. |
|
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 |