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
ERROR_CAN_NOT_COMPLETE	No se pudo completar la llamada a esta función.
ERROR_INSUFFICIENT_BUFFER	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.
ERROR_INVALID_PARAMETER	Identificador no válido para una enumeración.
ERROR_MORE_DATA	Hay más grupos disponibles.
ERROR_NO_MORE_ITEMS	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.
ERROR_NOT_ENOUGH_MEMORY	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

Consulte también

MgmGroupEnumerationEnd

MgmGroupEnumerationStart

SOURCE_GROUP_ENTRY