Share via


PFN_WER_RUNTIME_EXCEPTION_EVENT función de devolución de llamada (werapi.h)

Informe de errores de Windows (WER) llama a esta función para determinar si el controlador de excepciones está reclamando el bloqueo.

El tipo PFN_WER_RUNTIME_EXCEPTION_EVENT define un puntero a esta función de devolución de llamada. Debe usar "OutOfProcessExceptionEventCallback" como nombre de la función de devolución de llamada.

Sintaxis

PFN_WER_RUNTIME_EXCEPTION_EVENT PfnWerRuntimeExceptionEvent;

HRESULT PfnWerRuntimeExceptionEvent(
  [in]      PVOID pContext,
  [in]      const PWER_RUNTIME_EXCEPTION_INFORMATION pExceptionInformation,
  [out]     BOOL *pbOwnershipClaimed,
  [out]     PWSTR pwszEventName,
  [in, out] PDWORD pchSize,
  [out]     PDWORD pdwSignatureCount
)
{...}

Parámetros

[in] pContext

Puntero a información de contexto arbitraria que especificó cuando llamó a la función WerRegisterRuntimeExceptionModule para registrar el controlador de excepciones.

[in] pExceptionInformation

Estructura WER_RUNTIME_EXCEPTION_INFORMATION que contiene la información de excepción. Use la información para determinar si desea reclamar el bloqueo.

[out] pbOwnershipClaimed

Se establece en TRUE si el controlador de excepciones está reclamando este bloqueo; de lo contrario, FALSE. Si establece este parámetro en FALSE, no establezca el resto de los parámetros out.

[out] pwszEventName

Búfer asignado por el autor de la llamada que se usa para especificar el nombre del evento usado para identificar este bloqueo.

[in, out] pchSize

Tamaño, en caracteres, del búfer pwszEventName . El búfer está limitado a MAX_PATH caracteres. El tamaño incluye el carácter de terminación null.

[out] pdwSignatureCount

Número de parámetros de informe que proporcionará. El intervalo válido de valores es de uno a 10. Si especifica un valor mayor que 10, WER omitirá el valor y recopilará solo los 10 primeros parámetros. Si especifica cero, el proceso de informes será indeterminado.

Este valor determina el número de veces que WER llama a la función OutOfProcessExceptionEventSignatureCallback .

Valor devuelto

Devuelve S_OK, incluso si el controlador de excepciones no está reclamando este bloqueo. Si devuelve otros códigos de error, WER revierte a su comportamiento predeterminado de informes de bloqueos si no se registran otros controladores.

Comentarios

Debe implementar esta función en el archivo DLL del controlador de excepciones.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado werapi.h

Consulte también

WerRegisterRuntimeExceptionModule, Informe de errores de Windows