Compartir a través de

Función RaiseFailFastException (errhandlingapi.h)

  • Artículo

Genera una excepción que omite todos los controladores de excepciones (basado en fotogramas o vectores). La generación de esta excepción finaliza la aplicación e invoca Informe de errores de Windows, si Informe de errores de Windows está habilitada.

Sintaxis

void RaiseFailFastException(
  [in, optional] PEXCEPTION_RECORD pExceptionRecord,
  [in, optional] PCONTEXT          pContextRecord,
  [in]           DWORD             dwFlags
);

Parámetros

[in, optional] pExceptionRecord

Puntero a una estructura de EXCEPTION_RECORD que contiene la información de excepción. Debe especificar los miembros ExceptionAddress y ExceptionCode .

Si este parámetro es NULL, la función crea un registro de excepción y establece el miembro ExceptionCode en STATUS_FAIL_FAST_EXCEPTION. La función también establecerá el miembro ExceptionAddress si el parámetro dwFlags contiene la marca FAIL_FAST_GENERATE_EXCEPTION_ADDRESS.

[in, optional] pContextRecord

Puntero a una estructura CONTEXT que contiene la información de contexto. Si es NULL, esta función genera el contexto (sin embargo, el contexto no coincidirá exactamente con el contexto del autor de la llamada).

[in] dwFlags

Puede especificar cero o la marca siguiente que controla el comportamiento de esta función:

Valor Significado
FAIL_FAST_GENERATE_EXCEPTION_ADDRESS
0x1
 Hace que RaiseFailFastException establezca exceptionAddress de EXCEPTION_RECORD en la dirección de retorno de esta función (la siguiente instrucción del autor de la llamada después de la llamada a RaiseFailFastException). Esta función establecerá la dirección de excepción solo si ExceptionAddress no es NULL.

Valor devuelto

None

Observaciones

Normalmente, llama a esta función si la aplicación tiene un estado incorrecto y desea finalizar la aplicación inmediatamente y tener creado un informe de errores de Windows.

Si el servicio WER está deshabilitado o no se puede iniciar o no hay ningún depurador asociado al proceso, se finalizará el proceso.

Esta función genera una segunda excepción de oportunidad. Si la depuración JIT está habilitada, un depurador se asociará al proceso.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado errhandlingapi.h (incluya Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

Environment.FailFast