Función MgmGroupEnumerationGetNext (mgm.h)
La función MgmGroupEnumerationGetNext recupera el siguiente conjunto de entradas de grupo. La información devuelta por esta función es una lista de grupos unidos y los orígenes solicitados, si los hay.
Los grupos no se devuelven en ningún orden determinado.
Sintaxis
DWORD MgmGroupEnumerationGetNext(
[in] HANDLE hEnum,
[in, out] PDWORD pdwBufferSize,
[in, out] PBYTE pbBuffer,
[in, out] PDWORD pdwNumEntries
);
Parámetros
[in] hEnum
Identificador de la enumeración que se obtuvo de una llamada anterior a MgmGroupEnumerationStart.
[in, out] pdwBufferSize
En la entrada, pdwBufferSize es un puntero a una ubicación de memoria de tamaño DWORD que contiene el tamaño, en bytes, del búfer al que apunta pbBuffer.
En la salida, si el valor devuelto es ERROR_INSUFFICIENT_BUFFER, pdwBufferSize recibe el tamaño mínimo al que el búfer apuntado por pbBuffer debe ser para contener una entrada de grupo; de lo contrario, el valor de pdwBufferSize permanece sin cambios.
[in, out] pbBuffer
En la entrada, el cliente debe proporcionar un puntero a un búfer.
En la salida, pbBuffer contiene una o varias entradas de grupo. Cada entrada de grupo es una estructura SOURCE_GROUP_ENTRY .
[in, out] pdwNumEntries
En la entrada, el cliente debe proporcionar un puntero a un valor DWORD .
En la salida, pdwNumEntries recibe el número de grupos en pbBuffer.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es NO_ERROR.
Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.
| Valor | Significado |
|---|---|
|
No se pudo completar la llamada a esta función. |
|
El búfer especificado es demasiado pequeño para contener incluso un grupo. El cliente debe comprobar el valor de pdwBufferSize para el tamaño mínimo de búfer necesario para recuperar un grupo. |
|
Identificador no válido para una enumeración. |
|
Hay más grupos disponibles. |
|
No hay más grupos disponibles. Se devolvieron cero o más grupos; compruebe el valor de pdwNumEntries para comprobar cuántos grupos se devolvieron. |
|
Memoria insuficiente para completar esta operación. |
Requisitos
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | mgm.h |
| Library | Rtm.lib |
| Archivo DLL | Rtm.dll |