Condividi tramite


Funzione MgmGroupEnumerationStart (mgm.h)

La funzione MgmGroupEnumerationStart ottiene un handle di enumerazione usato in seguito per ottenere l'elenco di gruppi aggiunti. Dopo aver ottenuto l'handle, il client deve usare la funzione MgmGroupEnumerationGetNext per enumerare i gruppi.

Sintassi

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

Parametri

[in] hProtocol

Gestire il protocollo ottenuto da una chiamata precedente a MgmRegisterMProtocol.

[in] metEnumType

Specifica il tipo di enumerazione. Sono disponibili le enumerazioni seguenti.

Enumerazione Significato
ALL_SOURCES
Recupera join jolly (*, g) e join specifici dell'origine (s, g).
ANY_SOURCE
Recupera le voci del gruppo con almeno un'origine specificata.

[out] phEnumHandle

Riceve l'handle per l'enumerazione. Usare questo handle nelle chiamate a MgmGroupEnumerationGetNext e MgmGroupEnumerationEnd.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore Significato
ERROR_CAN_NOT_COMPLETE
Impossibile completare la chiamata a questa funzione.
ERROR_INVALID_PARAMETER
Handle non valido per un protocollo.
ERROR_NOT_ENOUGH_MEMORY
Memoria insufficiente per completare questa operazione.
 
 

Requisiti

Requisito Valore
Client minimo supportato Nessuno supportato
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione mgm.h
Libreria Rtm.lib
DLL Rtm.dll

Vedi anche

MGM_ENUM_TYPES

MgmGroupEnumerationEnd

MgmGroupEnumerationGetNext