Función MgmGroupEnumerationStart (mgm.h)

  • Artículo

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