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
Library Wevtapi.lib
DLL Wevtapi.dll

另请参阅

EvtNextChannelPath

EvtOpenChannelConfig