NetUserAdd: Unterschied zwischen den Versionen
Aus API-Wiki
(Die Seite wurde neu angelegt: __NOTOC__ ===== ===== Die API-Funktion '''NetUserAdd''' erstellt ein neues Benutzerkonto. <pre> Declare Function NetUserAdd Lib "netapi32.dll" ( _ ByV...) |
|||
Zeile 1: | Zeile 1: | ||
__NOTOC__ | __NOTOC__ | ||
===== ===== | ===== ===== | ||
− | Die API-Funktion | + | Die API-Funktion [[NetUserAdd]] erstellt ein neues Benutzerkonto. |
− | < | + | <code vb> |
Declare Function NetUserAdd Lib "netapi32.dll" ( _ | Declare Function NetUserAdd Lib "netapi32.dll" ( _ | ||
ByVal lpwServerName As Long, _ | ByVal lpwServerName As Long, _ | ||
Zeile 9: | Zeile 9: | ||
ByVal lpBuffer As Long, _ | ByVal lpBuffer As Long, _ | ||
ByRef lpParmError As Long) As Long | ByRef lpParmError As Long) As Long | ||
− | </ | + | </code> |
− | + | ==Parameter== | |
''lpwServerName'' | ''lpwServerName'' | ||
:[in] Zeiger auf einen Unicode String der den Rechnernamen angibt auf dem die Gruppe erstellt werden soll.<br>Der Rechnername muss mit "\\" beginnen. <br>Wird für diesen Parameter [[NULL]] übergeben, wird der lokale Computer verwendet | :[in] Zeiger auf einen Unicode String der den Rechnernamen angibt auf dem die Gruppe erstellt werden soll.<br>Der Rechnername muss mit "\\" beginnen. <br>Wird für diesen Parameter [[NULL]] übergeben, wird der lokale Computer verwendet | ||
Zeile 21: | Zeile 21: | ||
::4: lpBuffer zeigt auf eine [[USER_INFO_4]] Struktur | ::4: lpBuffer zeigt auf eine [[USER_INFO_4]] Struktur | ||
''lpBuffer'' | ''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. | + | :[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'' | ''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. | + | :[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). | 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. | 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: | Die API-Funktion ist unter folgenden Betriebssystemen funktionsfähig: | ||
*Windows NT 3.1 oder später | *Windows NT 3.1 oder später | ||
− | == | + | ==Verwandte Funktionen== |
*[[NetUserDel]] | *[[NetUserDel]] | ||
*[[NetGroupAdd]] | *[[NetGroupAdd]] | ||
*[[NetLocalGroupAdd]] | *[[NetLocalGroupAdd]] | ||
+ | [[Kategorie:Internet und Netzwerke]] | ||
[[Kategorie:NetApi]] | [[Kategorie:NetApi]] |
Version vom 13. Mai 2008, 10:39 Uhr
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