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 |