NetLocalGroupSetInfo-Funktion (lmaccess.h)
Die NetLocalGroupSetInfo-Funktion ändert den Namen einer vorhandenen lokalen Gruppe. Die Funktion ordnet auch einen Kommentar einer lokalen Gruppe zu.
Syntax
NET_API_STATUS NET_API_FUNCTION NetLocalGroupSetInfo(
[in] LPCWSTR servername,
[in] LPCWSTR groupname,
[in] DWORD level,
[in] LPBYTE buf,
[out] LPDWORD parm_err
);
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 des zu ändernden lokalen Gruppenkontos angibt. 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 Namen der lokalen Gruppe an. Der buf-Parameter verweist auf eine LOCALGROUP_INFO_0 Struktur. Verwenden Sie diese Ebene, um den Namen einer vorhandenen lokalen Gruppe zu ändern. |
|
Gibt den Namen der lokalen Gruppe und einen Kommentar an, der der Gruppe zugeordnet werden soll. Der buf-Parameter verweist auf eine LOCALGROUP_INFO_1-Struktur . |
|
Gibt einen Kommentar an, der der lokalen Gruppe zugeordnet werden soll. Der buf-Parameter verweist auf eine LOCALGROUP_INFO_1002-Struktur . |
[in] buf
Zeiger auf einen Puffer, der die informationen zur lokalen Gruppe enthält. Das Format dieser Daten hängt vom Wert des Ebenenparameters ab. Weitere Informationen finden Sie unter Netzwerkverwaltungsfunktionspuffer.
[out] parm_err
Zeiger auf einen Wert, der den Index des ersten Mitglieds der lokalen Gruppeninformationsstruktur empfängt, das den ERROR_INVALID_PARAMETER Fehler verursacht hat. Wenn dieser Parameter NULL ist, wird der Index nicht bei einem Fehler zurückgegeben. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
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. |
|
Einer der Funktionsparameter ist ungültig. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise". |
|
Die angegebene lokale Gruppe ist nicht vorhanden. |
|
Der Vorgang ist nur auf dem primären Domänencontroller der Domäne zulässig. |
|
Der Computername ist ungültig. |
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. In der Regel müssen Aufrufer Schreibzugriff auf das gesamte Objekt haben, damit Aufrufe dieser Funktion erfolgreich sind.
Um den neuen Namen einer vorhandenen lokalen Gruppe anzugeben, rufen Sie NetLocalGroupSetInfo mit LOCALGROUP_INFO_0 auf, und geben Sie einen Wert mit dem lgrpi0_name-Member an. Wenn Sie die NetLocalGroupSetInfo-Funktion mit LOCALGROUP_INFO_1 aufrufen und einen neuen Wert mithilfe des lgrpi1_name-Members angeben, wird dieser Wert ignoriert.
Wenn die NetLocalGroupSetInfo-Funktion ERROR_INVALID_PARAMETER zurückgibt, können Sie den parameter parm_err verwenden, um das erste Element der lokalen Gruppeninformationsstruktur anzugeben, das ungültig ist. (Eine lokale Gruppeninformationsstruktur beginnt mit LOCALGROUP_INFO_, und ihr Format wird durch den Ebenenparameter angegeben.) In der folgenden Tabelle sind die Werte aufgeführt, die im parm_err-Parameter zurückgegeben werden können, und dem entsprechenden Strukturmember, der fehlerhaft ist. (Das Präfix lgrpi*_ gibt an, dass das Element mit mehreren Präfixen beginnen kann, z. B. lgrpi0_ oder lgrpi1_.)
| Wert | Member |
|---|---|
| LOCALGROUP_NAME_PARMNUM | lgrpi*_name |
| LOCALGROUP_COMMENT_PARMNUM | lgrpi*_comment |
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
| 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 |