NetUserSetInfo

Aus API-Wiki
Zur Navigation springenZur Suche springen

Die API-Funktion NetUserSetInfo ändert Informationen eines Benutzerkontos. Diese Funktion kann auch zum Ändern des Kontopasswortes verwendet werden.

Declare Function NetUserSetInfo Lib "netapi32.dll" ( _ ByVal lpwServerName As Long, _

       		 ByVal lpwUserName 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 existiert.
Der Rechnername muss mit "\\" beginnen.
Wird für diesen Parameter NULL übergeben, wird der lokale Computer verwendet.

lpwGroupName

[in] Zeiger auf einen Unicode String der den Gruppennamen angibt.

Level

[in] Dieser Parameter bestimmt den Typ der im Parameter lpBuffer übergebenen Struktur:
Wert Bedeutung
0 lpBuffer zeigt auf eine USER_INFO_0 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
21 lpBuffer zeigt auf eine USER_INFO_21 Struktur
22 lpBuffer zeigt auf eine USER_INFO_22 Struktur
1003 lpBuffer zeigt auf eine USER_INFO_1003 Struktur
1005 lpBuffer zeigt auf eine USER_INFO_1005 Struktur
1006 lpBuffer zeigt auf eine USER_INFO_1006 Struktur
1007 lpBuffer zeigt auf eine USER_INFO_1007 Struktur
1008 lpBuffer zeigt auf eine USER_INFO_1008 Struktur
1009 lpBuffer zeigt auf eine USER_INFO_1009 Struktur
1010 lpBuffer zeigt auf eine USER_INFO_1010 Struktur
1011 lpBuffer zeigt auf eine USER_INFO_1011 Struktur
1012 lpBuffer zeigt auf eine USER_INFO_1012 Struktur
1014 lpBuffer zeigt auf eine USER_INFO_1014 Struktur
1017 lpBuffer zeigt auf eine USER_INFO_1017 Struktur
1020 lpBuffer zeigt auf eine USER_INFO_1020 Struktur
1024 lpBuffer zeigt auf eine USER_INFO_1024 Struktur
1051 lpBuffer zeigt auf eine USER_INFO_1051 Struktur
1052 lpBuffer zeigt auf eine USER_INFO_1052 Struktur
1053 lpBuffer zeigt auf eine USER_INFO_1053 Struktur

lpBuffer

[in] Zeiger auf eine USER_INFO_xxx Struktur welche die neuen Daten des Benutzerkontos enthält.

ParmError

[out] In diesem Longwert wird, im Falle eines ERROR_INVALID_PARAMETER Fehlers, der Index des ersten bemängelten Eintrags der GROUP_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

Verweise