Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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.
| Value | Meaning |
|---|---|
|
Could not complete the call to this function. |
|
The specified buffer is too small to hold even one group. The client should check the value of pdwBufferSize for the minimum buffer size required to retrieve one group. |
|
Invalid handle to an enumeration. |
|
More groups are available. |
|
No more groups are available. Zero or more groups were returned; check the value of pdwNumEntries to verify how many groups were returned. |
|
Not enough memory to complete this operation. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | None supported |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | mgm.h |
| Library | Rtm.lib |
| DLL | Rtm.dll |