NetGroupGetInfo-Funktion (lmaccess.h)

Artikel
08/24/2023

Die NetGroupGetInfo-Funktion ruft Informationen zu einer bestimmten globalen Gruppe in der Sicherheitsdatenbank ab, d. h. die SAM-Datenbank (Security Accounts Manager) oder im Fall von Domänencontrollern das Active Directory.

Syntax

NET_API_STATUS NET_API_FUNCTION NetGroupGetInfo(
  [in]  LPCWSTR servername,
  [in]  LPCWSTR groupname,
  [in]  DWORD   level,
  [out] LPBYTE  *bufptr
);

Parameter

[in] servername

Zeiger auf eine konstante Zeichenfolge, die den DNS- oder NetBIOS-Namen des Remoteservers angibt, auf dem die Funktion ausgeführt werden soll. Wenn dieser Parameter NULL ist, wird der lokale Computer verwendet.

[in] groupname

Zeiger auf eine konstante Zeichenfolge, die den Namen der globalen Gruppe angibt, für die Informationen abgerufen werden sollen. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

[in] level

Gibt die Informationsebene der Daten an. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
0	Gibt den namen der globalen Gruppe zurück. Der bufptr-Parameter verweist auf eine GROUP_INFO_0-Struktur .
1	Gibt den namen der globalen Gruppe und einen Kommentar zurück. Der bufptr-Parameter verweist auf eine GROUP_INFO_1 Struktur.
2	Gibt detaillierte Informationen zur globalen Gruppe zurück. Der bufptr-Parameter verweist auf eine GROUP_INFO_2-Struktur . Beachten Sie, dass Sie unter Windows XP und höher stattdessen GROUP_INFO_3 verwenden sollten.
3	Gibt detaillierte Informationen zur globalen Gruppe zurück. Der bufptr-Parameter verweist auf eine GROUP_INFO_3-Struktur . Windows 2000: Diese Ebene wird nicht unterstützt.

[out] bufptr

Zeiger auf die Adresse des Puffers, der die globale Gruppeninformationsstruktur empfängt. Das Format dieser Daten hängt vom Wert des Ebenenparameters ab. Das System weist den Speicher für diesen Puffer zu. Sie müssen die NetApiBufferFree-Funktion aufrufen, um die Speicherzuordnung zu beheben. Weitere Informationen finden Sie unter Netzwerkverwaltungsfunktionspuffer und Netzwerkverwaltungsfunktionspufferlängen.

Rückgabewert

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

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

Rückgabecode	Beschreibung
ERROR_ACCESS_DENIED	Der Benutzer besitzt keinen Zugriff auf die angeforderten Informationen.
NERR_InvalidComputer	Der Computername ist ungültig.
NERR_GroupNotFound	Der globale Gruppenname konnte nicht gefunden werden.

Hinweise

Wenn Sie für Active Directory programmieren, können Sie möglicherweise bestimmte ADSI-Methoden (Active Directory Service Interface) aufrufen, um dieselbe Funktionalität zu erzielen, die Sie durch aufrufen der Netzwerkverwaltungsgruppenfunktionen erreichen können. Weitere Informationen finden Sie unter IADsGroup.

Wenn Sie diese Funktion auf einem Domänencontroller aufrufen, auf dem Active Directory ausgeführt wird, wird der Zugriff basierend auf der Zugriffssteuerungsliste (Access Control List, ACL) für das sicherungsfähige Objekt zugelassen oder verweigert. Die Standard-ACL ermöglicht es allen authentifizierten Benutzern und Mitgliedern der Gruppe "Pre-Windows 2000-kompatibler Zugriff", die Informationen anzuzeigen. Wenn Sie diese Funktion auf einem Mitgliedsserver oder einer Arbeitsstation aufrufen, können alle authentifizierten Benutzer die Informationen anzeigen. Informationen zum anonymen Zugriff und zum Einschränken des anonymen Zugriffs auf diesen Plattformen finden Sie unter Sicherheitsanforderungen für die Netzwerkverwaltungsfunktionen. Weitere Informationen zu ACLs, ACEs und Zugriffstoken finden Sie unter Access Control Modell.

Die Sicherheitsbeschreibung des Group-Objekts wird verwendet, um die Zugriffsprüfung für diese Funktion durchzuführen.

Benutzerkontonamen sind auf 20 Zeichen und Gruppennamen auf 256 Zeichen beschränkt. Darüber hinaus können Kontonamen nicht durch einen Punkt beendet werden und dürfen keine Kommas oder eines der folgenden druckbaren Zeichen enthalten: ", /, , [, ], :, |, <, , >, +, =, ;, ?, *. Namen dürfen auch keine Zeichen im Bereich 1-31 enthalten, die nicht druckbar sind.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	lmaccess.h (lm.h einschließen)
Bibliothek	Netapi32.lib
DLL	Netapi32.dll