EvtOpenChannelEnum 函式 (winevt.h)

取得您用來列舉計算機上註冊之通道清單的句柄。

語法

EVT_HANDLE EvtOpenChannelEnum(
  [in] EVT_HANDLE Session,
  [in] DWORD      Flags
);

[in] Session

EvtOpenSession 函式傳回的遠端會話句柄。設定為 NULL 以列舉本機電腦上的通道。

[in] Flags

保留的。必須為零。

如果成功，函式會傳回計算機上註冊之通道名稱清單的句柄;否則為 NULL。如果 為 NULL，請呼叫 GetLastError 函式以取得錯誤碼。

列舉包含計算機上所定義之提供者的所有通道。若要列舉通道名稱，請在迴圈中呼叫 EvtNextChannelPath 函式。名稱會依字母順序排序。

您必須呼叫 EvtClose 函式，才能在完成時關閉列舉值句柄。

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