Funzione MgmGroupEnumerationStart (mgm.h)

Articolo
03/13/2024

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

Condividi tramite