MgmGroupEnumerationGetNext-Funktion (mgm.h)

Artikel
08/24/2023

Die MgmGroupEnumerationGetNext-Funktion ruft den nächsten Satz von Gruppeneinträgen ab. Die von dieser Funktion zurückgegebenen Informationen sind eine Liste der verknüpften Gruppen und ggf. die angeforderten Quellen.

Die Gruppen werden in keiner bestimmten Reihenfolge zurückgegeben.

Syntax

DWORD MgmGroupEnumerationGetNext(
  [in]      HANDLE hEnum,
  [in, out] PDWORD pdwBufferSize,
  [in, out] PBYTE  pbBuffer,
  [in, out] PDWORD pdwNumEntries
);

Parameter

[in] hEnum

Handle für die Enumeration, die aus einem vorherigen Aufruf von MgmGroupEnumerationStart abgerufen wurde.

[in, out] pdwBufferSize

Bei der Eingabe ist pdwBufferSize ein Zeiger auf einen Speicherort im DWORD-Format, der die Größe des Puffers in Byte enthält, auf den pbBuffer verweist.

Wenn der Rückgabewert bei der Ausgabe ERROR_INSUFFICIENT_BUFFER ist, empfängt pdwBufferSize die Mindestgröße, auf die der Puffer, auf den pbBuffer verweist, sein muss, um einen Gruppeneintrag zu enthalten; Andernfalls bleibt der Wert von pdwBufferSize unverändert.

[in, out] pbBuffer

Bei der Eingabe muss der Client einen Zeiger auf einen Puffer bereitstellen.

PbBuffer enthält bei der Ausgabe einen oder mehrere Gruppeneinträge. Jeder Gruppeneintrag ist eine SOURCE_GROUP_ENTRY-Struktur .

[in, out] pdwNumEntries

Bei der Eingabe muss der Client einen Zeiger auf einen DWORD-Wert bereitstellen.

Bei der Ausgabe empfängt pdwNumEntries die Anzahl der Gruppen in pbBuffer.

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_INSUFFICIENT_BUFFER	Der angegebene Puffer ist zu klein, um auch nur eine Gruppe aufzunehmen. Der Client sollte den Wert von pdwBufferSize auf die minimale Puffergröße überprüfen, die zum Abrufen einer Gruppe erforderlich ist.
ERROR_INVALID_PARAMETER	Ungültiges Handle für eine Enumeration.
ERROR_MORE_DATA	Weitere Gruppen sind verfügbar.
ERROR_NO_MORE_ITEMS	Es sind keine weiteren Gruppen verfügbar. Null oder mehr Gruppen wurden zurückgegeben; Überprüfen Sie den Wert von pdwNumEntries , um zu überprüfen, wie viele Gruppen zurückgegeben wurden.
ERROR_NOT_ENOUGH_MEMORY	Nicht genügend Arbeitsspeicher, um diesen Vorgang abzuschließen.

Anforderungen


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

MgmGroupEnumerationEnd

MgmGroupEnumerationStart

SOURCE_GROUP_ENTRY

Freigeben über