EvtOpenChannelEnum 函式 (winevt.h)

  • 發行項

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

語法

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

參數

[in] Session

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

[in] Flags

保留的。 必須為零。

傳回值

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

備註

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

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

範例

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

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 winevt.h
程式庫 Wevtapi.lib
Dll Wevtapi.dll

另請參閱

EvtNextChannelPath

EvtOpenChannelConfig