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 |