werReportSetParameter 函数 (werapi.h)

设置唯一标识指定Windows 错误报告 (WER) 报表的事件的参数。

语法

HRESULT WerReportSetParameter(
  [in]           HREPORT hReportHandle,
  [in]           DWORD   dwparamID,
  [in, optional] PCWSTR  pwzName,
  [in]           PCWSTR  pwzValue
);

参数

[in] hReportHandle

报表的句柄。 此句柄由 WerReportCreate 函数返回。

[in] dwparamID

要设置的参数的标识符。 此参数的取值可为下列值之一:

  • WER_P0
  • WER_P1
  • WER_P2
  • WER_P3
  • WER_P4
  • WER_P5
  • WER_P6
  • WER_P7
  • WER_P8
  • WER_P9

[in, optional] pwzName

指向包含参数名称的 Unicode 字符串的指针。 如果此参数为 NULL,则默认名称为 Px,其中 xdwparamID 中指定的值的整数部分匹配。

[in] pwzValue

{1}参数值。{2}

返回值

此函数在成功 时返回S_OK 或失败时返回错误代码,包括以下错误代码。

返回代码 说明
E_HANDLE 指定的句柄无效。
WER_E_LENGTH_EXCEEDED 一个或多个字符串参数的长度已超出其限制。

备注

每个报表都支持参数 P0 到 P9。 此函数一次设置一个参数。 如果设置了参数 Px ,则必须设置 P0 和 Px 中的所有参数。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 werapi.h
Library Wer.lib
DLL Wer.dll

另请参阅

WerReportCreateWindows 错误报告