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。

如果函式失敗，傳回值就是下列其中一個錯誤碼。