EvtOpenChannelEnum 函数 (winevt.h)

获取用于枚举计算机上注册的通道列表的句柄。

语法

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

[in] Session

EvtOpenSession 函数返回的远程会话句柄。设置为 NULL 以枚举本地计算机上的通道。

[in] Flags

保留。必须为零。

如果成功，函数将返回计算机上注册的通道名称列表的句柄;否则为 NULL。如果 为 NULL，则调用 GetLastError 函数以获取错误代码。

枚举包括在计算机上注册的提供程序定义的所有通道。若要枚举通道名称，请在循环中调用 EvtNextChannelPath 函数。名称按字母顺序排序。

完成后，必须调用 EvtClose 函数以关闭枚举器句柄。

有关演示如何使用此函数的示例，请参阅获取和设置通道的配置属性。