Función UnhandledExceptionFilter (errhandlingapi.h)

Artículo
08/23/2023

Función definida por la aplicación que pasa excepciones no controladas al depurador, si el proceso se está depurando. De lo contrario, opcionalmente muestra un cuadro de mensaje error de aplicación y hace que se ejecute el controlador de excepciones. Solo se puede llamar a esta función desde dentro de la expresión de filtro de un controlador de excepciones.

Sintaxis

LONG UnhandledExceptionFilter(
  [in] _EXCEPTION_POINTERS *ExceptionInfo
);

Parámetros

[in] ExceptionInfo

Puntero a una estructura de EXCEPTION_POINTERS que especifica una descripción de la excepción y el contexto del procesador en el momento de la excepción. Este puntero es el valor devuelto de una llamada a la función GetExceptionInformation .

Valor devuelto

La función devuelve uno de los valores siguientes.

Código o valor devuelto	Descripción
EXCEPTION_CONTINUE_SEARCH 0x0	El proceso se está depurando, por lo que la excepción debe pasarse (como segunda oportunidad) al depurador de la aplicación.
EXCEPTION_EXECUTE_HANDLER 0x1	Si la marca SEM_NOGPFAULTERRORBOX se especificó en una llamada anterior a SetErrorMode, no se muestra ningún cuadro de mensaje de error de aplicación. La función devuelve el control al controlador de excepciones, que es libre de realizar cualquier acción adecuada.

Comentarios

Si el proceso no se está depurando, la función muestra un cuadro de mensaje Error de aplicación, en función del modo de error actual. El comportamiento predeterminado es mostrar el cuadro de diálogo, pero esto se puede deshabilitar especificando SEM_NOGPFAULTERRORBOX en una llamada a la función SetErrorMode .

El sistema usa UnhandledExceptionFilter internamente para controlar las excepciones que se producen durante la creación del proceso y del subproceso.

Requisitos


Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	errhandlingapi.h (incluir Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll