PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE回调函数 (werapi.h)

  • 项目

Windows 错误报告 (WER) 调用此函数以获取唯一描述问题的报告参数。

PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE类型定义指向此回调函数的指针。 必须使用“OutOfProcessExceptionEventSignatureCallback”作为回调函数的名称。

语法

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
)
{...}

参数

[in] pContext

指向在调用 WerRegisterRuntimeExceptionModule 函数以注册异常处理程序时指定的任意上下文信息的指针。

[in] pExceptionInformation

包含异常信息的 WER_RUNTIME_EXCEPTION_INFORMATION 结构。

[in] dwIndex

报表参数的索引。 有效值为 0 到 9。 对此函数的第一次调用必须将索引设置为 0，并且每次连续调用都必须按顺序递增索引值。

[out] pwszName

调用方分配的缓冲区，用于指定参数名称。

[in, out] pchName

pwszName 缓冲区的大小（以字符为单位）。 大小包括 null 终止字符。

[out] pwszValue

调用方分配的缓冲区，用于指定参数值。

[in, out] pchValue

pwszValue 缓冲区的大小（以字符为单位）。 大小包括 null 终止字符。

返回值

成功返回 S_OK 。 如果返回其他失败代码，WER 将还原为其默认的崩溃报告行为。

注解

必须在异常处理程序 DLL 中实现此函数。

若要为特定于应用程序的问题生成错误报告，应用程序必须使用一些基本信息（称为报表参数）创建问题的简短说明。 报表参数包括应用程序名称、应用程序版本、模块名称、模块版本和错误代码等信息。 这些报表参数的组合描述了一个独特的问题。

仅当将 OutOfProcessExceptionEventCallback 回调函数的 pbOwnershipClaimed 参数设置为 TRUE 时，WER 才会调用此回调函数。 OutOfProcessExceptionEventCallback 的 pdwSignatureCount 参数确定 WER 调用此回调函数的次数。

要求

要求 值
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 werapi.h

另请参阅

WerRegisterRuntimeExceptionModule，Windows 错误报告