Compartir a través de


Función UnhandledExceptionFilter (errhandlingapi.h)

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

Vea también

EXCEPTION_POINTERS

GetExceptionInformation

SetErrorMode

SetUnhandledExceptionFilter

Funciones del control de excepciones estructurado

Información general del control de excepciones estructurado