MgmGroupEnumerationStart-Funktion (mgm.h)

Artikel
03/06/2024

Die MgmGroupEnumerationStart-Funktion ruft ein Enumerationshandle ab, das später verwendet wird, um die Liste der verknüpften Gruppen abzurufen. Nachdem der Client das Handle abgerufen hat, sollte er die MgmGroupEnumerationGetNext-Funktion verwenden, um die Gruppen aufzulisten.

Syntax

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

Parameter

[in] hProtocol

Handle mit dem Protokoll, das von einem vorherigen Aufruf von MgmRegisterMProtocol abgerufen wurde.

[in] metEnumType

Gibt den Enumerationstyp an. Die folgenden Enumerationen sind verfügbar.

Enumeration	Bedeutung
ALL_SOURCES	Ruft Wildcard-Joins (*, g) und quellspezifische Joins (s, g) ab.
ANY_SOURCE	Ruft Gruppeneinträge ab, für die mindestens eine Quelle angegeben ist.

[out] phEnumHandle

Empfängt das Handle für die Enumeration. Verwenden Sie dieses Handle in Aufrufen von MgmGroupEnumerationGetNext und MgmGroupEnumerationEnd.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Wert	Bedeutung
ERROR_CAN_NOT_COMPLETE	Der Aufruf dieser Funktion konnte nicht abgeschlossen werden.
ERROR_INVALID_PARAMETER	Ungültiges Handle für ein Protokoll.
ERROR_NOT_ENOUGH_MEMORY	Nicht genügend Arbeitsspeicher, um diesen Vorgang abzuschließen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mgm.h
Bibliothek	Rtm.lib
DLL	Rtm.dll

Weitere Informationen

MGM_ENUM_TYPES

MgmGroupEnumerationEnd

MgmGroupEnumerationGetNext

Freigeben über