Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 |