EvtOpenChannelConfig 函式 (winevt.h)

取得您用來讀取或修改通道組態屬性的控制碼。

語法

EVT_HANDLE EvtOpenChannelConfig(
  [in] EVT_HANDLE Session,
  [in] LPCWSTR    ChannelPath,
  [in] DWORD      Flags
);

[in] Session

EvtOpenSession 函式傳回的遠端會話控制碼。設定為 Null ，以存取本機電腦上的通道。

[in] ChannelPath

要存取的通道名稱。

[in] Flags

保留的。必須為零。

如果成功，函式會傳回信道組態的控制碼;否則為 Null。如果 為 Null，請呼叫 GetLastError 函式以取得錯誤碼。

若要取得組態屬性，請呼叫 EvtGetChannelConfigProperty 函式。

若要修改組態屬性，請呼叫 EvtSetChannelConfigProperty 函式。若要儲存設定變更，請呼叫 EvtSaveChannelConfig 函式。

若要列舉已註冊的通道，請呼叫 EvtOpenChannelEnum 函式。

您必須呼叫 EvtClose 函式，才能在完成時關閉控制碼。

如需示範如何使用此函式的範例，請參閱取得和設定通道的組態屬性。