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。

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

値 説明
ERROR_CAN_NOT_COMPLETE
 この関数の呼び出しを完了できませんでした。
ERROR_INSUFFICIENT_BUFFER
 指定されたバッファーが小さすぎて、1 つのグループを保持できません。 クライアントは、1 つのグループを取得するために必要な最小バッファー サイズに対して pdwBufferSize の値をチェックする必要があります。
ERROR_INVALID_PARAMETER
 列挙型のハンドルが無効です。
ERROR_MORE_DATA
 その他のグループも利用できます。
ERROR_NO_MORE_ITEMS
 これ以上グループを使用できません。 0 個以上のグループが返されました。pdwNumEntries の値をチェックして、返されたグループの数を確認します。
ERROR_NOT_ENOUGH_MEMORY
 この操作を完了するのに十分なメモリがありません。
 
 

要件

   
サポートされている最小のクライアント サポートなし
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー mgm.h
Library Rtm.lib
[DLL] Rtm.dll

関連項目

MgmGroupEnumerationEnd

MgmGroupEnumerationStart

SOURCE_GROUP_ENTRY