mgmGroupEnumerationStart 函数 (mgm.h)

MgmGroupEnumerationStart 函数获取枚举句柄，该句柄稍后用于获取已加入的组的列表。客户端获取句柄后，应使用 MgmGroupEnumerationGetNext 函数枚举组。

语法

DWORD MgmGroupEnumerationStart(
  [in]  HANDLE         hProtocol,
  [in]  MGM_ENUM_TYPES metEnumType,
  [out] HANDLE         *phEnumHandle
);

[in] hProtocol

从先前调用 MgmRegisterMProtocol 获取的协议的句柄。

[in] metEnumType

指定枚举的类型。以下枚举可用。

枚举	含义
ALL_SOURCES	检索通配符联接 (*、g) 和特定于源的联接 (s、g) 。
ANY_SOURCE	检索至少指定了一个源的组条目。

[out] phEnumHandle

接收枚举的句柄。在调用 MgmGroupEnumerationGetNext 和 MgmGroupEnumerationEnd 时使用此句柄。

如果函数成功，则返回值NO_ERROR。

如果函数失败，则返回值为以下错误代码之一。