共用方式為


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 參數不是有效的提供者註冊控制碼、 EventInformationNullInformationLength 為非零,或指定的 InformationLength 對指定的 InformationClass無效,則會傳回此錯誤。
  • ERROR_NOT_SUPPORTED:不支援要求。 如果 InformationClass 參數不是可辨識的值,就會傳回此錯誤。
  • 其他:使用 FormatMessage 取得傳回錯誤的訊息字串。

需求

   
最低支援的用戶端 Windows 8 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2012 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 evntprov.h
程式庫 Advapi32.lib
Dll Advapi32.dll

另請參閱

EVENT_INFO_CLASS

EventRegister