通过

mgmGroupEnumerationGetNext 函数 (mgm.h)

  • 项目

MgmGroupEnumerationGetNext 函数检索下一组组条目。 此函数返回的信息是已加入的组和请求的源（如果有）的列表。

这些组不会按任何特定顺序返回。

语法

DWORD MgmGroupEnumerationGetNext(
  [in]      HANDLE hEnum,
  [in, out] PDWORD pdwBufferSize,
  [in, out] PBYTE  pbBuffer,
  [in, out] PDWORD pdwNumEntries
);

parameters

[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
Library Rtm.lib
DLL Rtm.dll

另请参阅

MgmGroupEnumerationEnd

MgmGroupEnumerationStart

SOURCE_GROUP_ENTRY