共用方式為

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 是 DWORD大小的記憶體位置指標，其中包含 pbBuffer所指向緩衝區的大小，以位元組為單位。

在輸出中，如果傳回值ERROR_INSUFFICIENT_BUFFER， pdwBufferSize 會收到 pbBuffer 所指向緩衝區必須保留群組專案的最低大小;否則 pdwBufferSize 的值會保持不變。

[in, out] pbBuffer

在輸入時，用戶端必須提供緩衝區的指標。

在輸出時， pbBuffer 包含一或多個群組專案。 每個群組專案都是 SOURCE_GROUP_ENTRY 結構。

[in, out] pdwNumEntries

在輸入時，用戶端必須提供 DWORD 值的指標。

在輸出時， pdwNumEntries 會接收 pbBuffer中的群組數目。

傳回值

如果函式成功，傳回值會NO_ERROR。

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

值 意義
ERROR_CAN_NOT_COMPLETE
 無法完成此函式的呼叫。
ERROR_INSUFFICIENT_BUFFER
 指定的緩衝區太小，無法保留一個群組。 用戶端應該檢查 pdwBufferSize 的值，以取得擷取一個群組所需的最小緩衝區大小。
ERROR_INVALID_PARAMETER
 列舉的控制碼無效。
ERROR_MORE_DATA
 有更多群組可供使用。
ERROR_NO_MORE_ITEMS
 沒有其他可用的群組。 傳回零或多個群組;檢查 pdwNumEntries 的值，以確認傳回的群組數目。
ERROR_NOT_ENOUGH_MEMORY
 記憶體不足，無法完成此作業。
 
 

需求

   
最低支援的用戶端 都不支援
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 mgm.h
程式庫 Rtm.lib
Dll Rtm.dll

另請參閱

MgmGroupEnumerationEnd

MgmGroupEnumerationStart

SOURCE_GROUP_ENTRY