NetLocalGroupAdd: Unterschied zwischen den Versionen

Aus API-Wiki
Wechseln zu: Navigation, Suche
 
Zeile 2: Zeile 2:
 
Die API-Funktion [[NetLocalGroupAdd]] erstellt eine neue lokale Benutzergruppe.
 
Die API-Funktion [[NetLocalGroupAdd]] erstellt eine neue lokale Benutzergruppe.
  
<code vb>
+
<syntaxhighlight lang="vb">
 
Declare Function NetLocalGroupAdd Lib "netapi32.dll" ( _
 
Declare Function NetLocalGroupAdd Lib "netapi32.dll" ( _
 
                 ByVal lpwServerName As Long, _
 
                 ByVal lpwServerName As Long, _
Zeile 8: Zeile 8:
 
                 ByVal lpBuffer As Long, _
 
                 ByVal lpBuffer As Long, _
 
                 ByRef ParmError As Long) As Long
 
                 ByRef ParmError As Long) As Long
</code>
+
</syntaxhighlight>
  
 
==Parameter==
 
==Parameter==

Aktuelle Version vom 7. Oktober 2016, 21:24 Uhr

Die API-Funktion NetLocalGroupAdd erstellt eine neue lokale Benutzergruppe.

Declare Function NetLocalGroupAdd Lib "netapi32.dll" ( _
                 ByVal lpwServerName As Long, _
                 ByVal Level As Long, _
                 ByVal lpBuffer As Long, _
                 ByRef ParmError As Long) As Long

Parameter

lpwServerName

[in] Zeiger auf einen Unicode String der den Rechnernamen angibt auf dem die Gruppe erstellt werden soll.
Der Rechnername muss mit "\\" beginnen.
Wird für diesen Parameter NULL übergeben, wird der lokale Computer verwendet

Level

[in] Dieser Parameter bestimmt den Typ der im Parameter lpBuffer übergebenen Struktur:
0: lpBuffer zeigt auf eine GROUP_INFO_0 Struktur
1: lpBuffer zeigt auf eine GROUP_INFO_1 Struktur

lpBuffer

[in] Zeiger auf eine GROUP_INFO_0, GROUP_INFO_1, GROUP_INFO_2 oder GROUP_INFO_3 Struktur die die Daten der neu anzulegenden Gruppe definiert.

ParmError

[out] In diesem Longwert wird, im Falle eines ERROR_INVALID_PARAMETER Fehlers (siehe Rückgabe), der Index des ersten bemängelten Eintrags der GROUP_INFO_0, GROUP_INFO_1, GROUP_INFO_2 oder GROUP_INFO_3 Struktur zurückgegeben.

Rückgaben

War die Funktion erfolgreich, so erfolgt die Rückgabe des Wertes 0 (NERR_Success).
Andere mögliche Rückgabewerte sind:

Konstante Beschreibung
ERROR_ACCESS_DENIED Zugriff verweigert
ERROR_ALIAS_EXISTS der geforderte Gruppenname existiert bereits als Alias
NERR_InvalidComputer falscher Computername im Parameter lpwServerName
NERR_GroupExists eine Gruppe mit diesem Namen existiert bereits
NERR_NotPrimary bei dem im Parameter lpwServerName übergebenen Computernamen handelt es sich nicht um den Primären Domaincontroller
ERROR_INVALID_LEVEL der im Parameter Level übergebene Wert ist ungültig
NERR_UserExists ein Benutzer mit diesem Namen existiert bereits
ERROR_INVALID_PARAMETER ein übergebener Parameter is nicht gültig

Hinweise

Beachten Sie, dass die Funktion nur als Unicode Funktion implementiert ist. Um die von VB automatisch durchgeführte Umwandlung von String Parametern in ANSI Strings zu unterbinden sind die Parameter 'As Long' deklariert und müssen mit StrPtr(MyString) übergeben werden.

Betriebssystem

Die API-Funktion NetLocalGroupAdd ist unter folgenden Betriebssystemen funktionsfähig:

  • Windows NT 3.1 oder später

Verweise