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 |
| 程式庫 | Advapi32.lib |
| Dll | Advapi32.dll |