MgmGroupEnumerationGetNext function (mgm.h)

The MgmGroupEnumerationGetNext function retrieves the next set of group entries. The information that is returned by this function is a list of groups joined and the sources requested, if any.

The groups are not returned in any particular order.

Syntax

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

Parameters

[in] hEnum

Handle to the enumeration that was obtained from a previous call to MgmGroupEnumerationStart.

[in, out] pdwBufferSize

On input, pdwBufferSize is a pointer to a DWORD-sized memory location that contains the size, in bytes, of the buffer pointed to by pbBuffer.

On output, if the return value is ERROR_INSUFFICIENT_BUFFER, pdwBufferSize receives the minimum size that the buffer pointed to by pbBuffer must be to hold a group entry; otherwise the value of pdwBufferSize remains unchanged.

[in, out] pbBuffer

On input, the client must supply a pointer to a buffer.

On output, pbBuffer contains one or more group entries. Each group entry is a SOURCE_GROUP_ENTRY structure.

[in, out] pdwNumEntries

On input, the client must supply a pointer to a DWORD value.

On output, pdwNumEntries receives the number of groups in pbBuffer.

Return value

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value is one of the following error codes.

Requirements

See also

MgmGroupEnumerationEnd

MgmGroupEnumerationStart

SOURCE_GROUP_ENTRY