Compartir a través de

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

  • Artículo

Informe de errores de Windows (WER) llama a esta función para obtener los parámetros de informe que describen de forma única el problema.

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

Sintaxis

PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE PfnWerRuntimeExceptionEventSignature;

HRESULT PfnWerRuntimeExceptionEventSignature(
  [in]      PVOID pContext,
  [in]      const PWER_RUNTIME_EXCEPTION_INFORMATION pExceptionInformation,
  [in]      DWORD dwIndex,
  [out]     PWSTR pwszName,
  [in, out] PDWORD pchName,
  [out]     PWSTR pwszValue,
  [in, out] PDWORD pchValue
)
{...}

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.

[in] dwIndex

Índice del parámetro de informe. Los valores válidos son de 0 a 9. La primera llamada a esta función debe establecer el índice en 0 y cada llamada sucesiva debe incrementar secuencialmente el valor del índice.

[out] pwszName

Búfer asignado por el autor de la llamada que se usa para especificar el nombre del parámetro.

[in, out] pchName

Tamaño, en caracteres, del búfer pwszName . El tamaño incluye el carácter de terminación null.

[out] pwszValue

Búfer asignado por el autor de la llamada que se usa para especificar el valor del parámetro.

[in, out] pchValue

Tamaño, en caracteres, del búfer pwszValue . El tamaño incluye el carácter de terminación null.

Valor devuelto

Devuelve S_OK si se ha realizado correctamente. Si devuelve otros códigos de error, WER vuelve a su comportamiento predeterminado de informes de bloqueos.

Comentarios

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

Para generar informes de errores para problemas específicos de la aplicación, la aplicación debe crear una breve descripción del problema mediante unas cuantas partes básicas de información denominadas parámetros de informe. Los parámetros de informe incluyen información como el nombre de la aplicación, la versión de la aplicación, el nombre del módulo, la versión del módulo y el código de error. La combinación de estos parámetros de informe describe un problema único.

WER llama a esta función de devolución de llamada solo si establece el parámetro pbOwnershipClaimed de la función de devolución de llamada OutOfProcessExceptionEventCallback en TRUE. El parámetro pdwSignatureCount de OutOfProcessExceptionEventCallback determina el número de veces que WER llamará a esta función de devolución de llamada.

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