Función MgmGroupEnumerationStart (mgm.h)

La función MgmGroupEnumerationStart obtiene un identificador de enumeración que se usa más adelante para obtener la lista de grupos que se han unido. Una vez que el cliente obtiene el identificador, debe usar la función MgmGroupEnumerationGetNext para enumerar los grupos.

Sintaxis

DWORD MgmGroupEnumerationStart(
  [in]  HANDLE         hProtocol,
  [in]  MGM_ENUM_TYPES metEnumType,
  [out] HANDLE         *phEnumHandle
);

Parámetros

[in] hProtocol

Controle el protocolo obtenido de una llamada anterior a MgmRegisterMProtocol.

[in] metEnumType

Especifica el tipo de enumeración. Están disponibles las enumeraciones siguientes.

Enumeración	Significado
ALL_SOURCES	Recupera combinaciones de caracteres comodín (*, g) y combinaciones específicas del origen (s, g).
ANY_SOURCE	Recupera entradas de grupo que tienen al menos un origen especificado.

[out] phEnumHandle

Recibe el identificador de la enumeración. Use este identificador en las llamadas a MgmGroupEnumerationGetNext y MgmGroupEnumerationEnd.

Valor devuelto

Si la función se ejecuta 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_INVALID_PARAMETER	Identificador no válido para un protocolo.
ERROR_NOT_ENOUGH_MEMORY	No hay suficiente memoria para completar esta operación.

 

 

Requisitos

Requisito	Value
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

MGM_ENUM_TYPES

MgmGroupEnumerationEnd

MgmGroupEnumerationGetNext