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	少なくとも 1 つのソースが指定されているグループエントリを取得します。

[out] phEnumHandle

列挙へのハンドルを受け取ります。このハンドルは、 MgmGroupEnumerationGetNext と MgmGroupEnumerationEnd の呼び出しで使用します。

関数が成功した場合、戻り値はNO_ERROR。

関数が失敗した場合、戻り値は次のいずれかのエラーコードになります。