EventSetInformation 函数 (evntprov.h)

配置 ETW 事件提供程序。

语法

ULONG EVNTAPI EventSetInformation(
  [in] REGHANDLE        RegHandle,
  [in] EVENT_INFO_CLASS InformationClass,
  [in] PVOID            EventInformation,
  [in] ULONG            InformationLength
);

参数

[in] RegHandle

事件提供程序注册句柄。 这是 EventRegister 返回的句柄。

[in] InformationClass

EVENT_INFO_CLASS 值，该值指定要对事件提供程序执行的配置操作。

[in] EventInformation

指向缓冲区的指针，该缓冲区包含配置事件提供程序时要使用的数据。 此缓冲区中的数据格式取决于 InformationClass 参数中指定的值。

如果 InformationLength 为零，则此值可能为 NULL 。

[in] InformationLength

eventInformation 缓冲区中数据) 的大小 (字节数。

返回值

如果函数成功，则返回值 ERROR_SUCCESS。

如果函数失败，则返回值为以下错误代码之一。

• ERROR_INVALID_PARAMETER：参数不正确。 例如，如果 RegHandle 参数不是有效的提供程序注册句柄、 EventInformation 为 NULL 但 InformationLength 为非零值，或者指定的 InformationLength 对给定 的 InformationClass 无效，则返回此错误。
• ERROR_NOT_SUPPORTED：不支持请求。 如果 InformationClass 参数不是可识别的值，则返回此错误。
• 其他：使用 FormatMessage 获取返回错误的消息字符串。

要求

最低受支持的客户端	Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器	Windows Server 2012 [桌面应用 |UWP 应用]
目标平台	Windows
标头	evntprov.h
Library	Advapi32.lib
DLL	Advapi32.dll

请参阅

EVENT_INFO_CLASS

EventRegister