MgmGroupEnumerationGetNext 関数 (mgm.h)
MgmGroupEnumerationGetNext 関数は、グループ エントリの次のセットを取得します。 この関数によって返される情報は、参加しているグループと要求されたソース (存在する場合) の一覧です。
グループは、特定の順序で返されません。
構文
DWORD MgmGroupEnumerationGetNext(
[in] HANDLE hEnum,
[in, out] PDWORD pdwBufferSize,
[in, out] PBYTE pbBuffer,
[in, out] PDWORD pdwNumEntries
);
パラメーター
[in] hEnum
MgmGroupEnumerationStart の以前の呼び出しから取得した列挙体を処理します。
[in, out] pdwBufferSize
入力時、pdwBufferSize は、pbBuffer が指すバッファーのサイズ (バイト単位) を含む DWORD サイズのメモリ位置へのポインターです。
出力時に戻り値がERROR_INSUFFICIENT_BUFFER場合、 pdwBufferSize は 、pbBuffer が指すバッファーがグループ エントリを保持するために必要な最小サイズを受け取ります。それ以外の場合、 pdwBufferSize の値は変更されません。
[in, out] pbBuffer
入力時に、クライアントはバッファーへのポインターを指定する必要があります。
出力時に、 pbBuffer には 1 つ以上のグループ エントリが含まれます。 各グループ エントリは 、SOURCE_GROUP_ENTRY 構造です。
[in, out] pdwNumEntries
入力時に、クライアントは DWORD 値へのポインターを指定する必要があります。
出力時に、 pdwNumEntries は pbBuffer 内のグループの数を受け取ります。
戻り値
関数が成功した場合、戻り値はNO_ERROR。
関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。
値 | 説明 |
---|---|
|
この関数の呼び出しを完了できませんでした。 |
|
指定されたバッファーが小さすぎて、1 つのグループを保持できません。 クライアントは、1 つのグループを取得するために必要な最小バッファー サイズに対して pdwBufferSize の値をチェックする必要があります。 |
|
列挙型のハンドルが無効です。 |
|
その他のグループも利用できます。 |
|
これ以上グループを使用できません。 0 個以上のグループが返されました。pdwNumEntries の値をチェックして、返されたグループの数を確認します。 |
|
この操作を完了するのに十分なメモリがありません。 |
要件
サポートされている最小のクライアント | サポートなし |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | mgm.h |
Library | Rtm.lib |
[DLL] | Rtm.dll |