NetLocalGroupDelMembers-Funktion (lmaccess.h)
Die NetLocalGroupDelMembers-Funktion entfernt mindestens ein Mitglied aus einer vorhandenen lokalen Gruppe. Lokale Gruppenmitglieder können Benutzer oder globale Gruppen sein.
Syntax
NET_API_STATUS NET_API_FUNCTION NetLocalGroupDelMembers(
[in] LPCWSTR servername,
[in] LPCWSTR groupname,
[in] DWORD level,
[in] LPBYTE buf,
[in] DWORD totalentries
);
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 lokalen Gruppe angibt, aus der die angegebenen Benutzer oder globalen Gruppen entfernt werden. 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 |
|---|---|
|
Gibt den Sicherheitsbezeichner (SID) eines zu entfernenden lokalen Gruppenmitglieds an. Der buf-Parameter verweist auf ein Array von LOCALGROUP_MEMBERS_INFO_0 Strukturen. |
|
Gibt die Domäne und den Namen eines zu entfernenden lokalen Gruppenmitglieds an. Der buf-Parameter verweist auf ein Array von LOCALGROUP_MEMBERS_INFO_3 Strukturen. |
[in] buf
Zeiger auf einen Puffer, der die zu entfernenden Member angibt. Das Format dieser Daten hängt vom Wert des Ebenenparameters ab. Weitere Informationen finden Sie unter Netzwerkverwaltungsfunktionspuffer.
[in] totalentries
Gibt die Anzahl der Einträge in dem Array an, auf das der buf-Parameter verweist.
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 |
|---|---|
|
Der Benutzer besitzt keinen Zugriff auf die angeforderten Informationen. |
|
Die durch den groupname-Parameter angegebene lokale Gruppe ist nicht vorhanden. |
|
Mindestens eins der angegebenen Member ist nicht vorhanden. Es wurden keine Mitglieder gelöscht. |
|
Mindestens eins der angegebenen Mitglieder waren keine Mitglieder der lokalen Gruppe. Es wurden keine Mitglieder gelöscht. |
Hinweise
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 erlaubt nur Domänenadministratoren und Kontooperatoren, diese Funktion aufzurufen. Auf einem Mitgliedsserver oder einer Arbeitsstation können nur Administratoren und Power Users diese Funktion aufrufen. Weitere Informationen finden Sie unter Sicherheitsanforderungen für die Netzwerkverwaltungsfunktionen. Weitere Informationen zu ACLs, ACEs und Zugriffstoken finden Sie unter Access Control Modell.
Die Sicherheitsbeschreibung des LocalGroup-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.
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 lokalen Gruppenfunktionen der Netzwerkverwaltung erreichen können. Weitere Informationen finden Sie unter IADsGroup.
Anforderungen
| 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 |