NetUserAdd

Aus API-Wiki
Version vom 7. Oktober 2016, 21:24 Uhr von Jochen Wierum (Diskussion | Beiträge)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Zur Navigation springenZur Suche springen

Die API-Funktion NetUserAdd erstellt ein neues Benutzerkonto.

Declare Function NetUserAdd Lib "netapi32.dll" ( _
                 ByVal lpwServerName As Long, _
                 ByVal Level As Long, _
                 ByVal lpBuffer As Long, _
                 ByRef lpParmError 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:
1: lpBuffer zeigt auf eine USER_INFO_1 Struktur
2: lpBuffer zeigt auf eine USER_INFO_2 Struktur
3: lpBuffer zeigt auf eine USER_INFO_3 Struktur
4: lpBuffer zeigt auf eine USER_INFO_4 Struktur

lpBuffer

[in] Zeiger auf eine USER_INFO_1, USER_INFO_2, USER_INFO_3 oder USER_INFO_4 Struktur die Daten des neu anzulegenden Kontos definiert.

lpParmError

[out] In diesem Longwert wird, im Falle eines ERROR_INVALID_PARAMETER Fehlers, der Index des ersten bemängelten Eintrags der USER_INFO Struktur zurückgegeben.

Rückgabe

War die Funktion erfolgreich, so erfolgt die Rückgabe des Wertes 0 (NERR_Success).

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 ist unter folgenden Betriebssystemen funktionsfähig:

  • Windows NT 3.1 oder später

Verwandte Funktionen