NetUserGetInfo

Aus API-Wiki
Version vom 20. März 2007, 16:20 Uhr von Danielo (Diskussion | Beiträge) (Die Seite wurde neu angelegt: __NOTOC__ ===== ===== Die API-Funktion '''NetUserGetInfo''' ermittelt Informationen zu einem Benutzerkonto. <pre> Declare Function NetUserGetInfo Lib "netapi32.dll" ( ...)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Zur Navigation springenZur Suche springen

Die API-Funktion NetUserGetInfo ermittelt Informationen zu einem Benutzerkonto.

Declare Function NetUserGetInfo Lib "netapi32.dll" ( _
                 ByVal lpwServerName As Long, _
                 ByVal lpwUserName As Long, _
                 ByVal Level As Long, _
                 ByRef lpBuffer As Long) As Long
Parameter:

lpwServerName

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

lpwUserName

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

Level

[in] Dieser Parameter bestimmt den Typ der in lpBuffer zurückgegebenen Struktur:
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
10: lpBuffer zeigt auf eine USER_INFO_10 Struktur
11: lpBuffer zeigt auf eine USER_INFO_11 Struktur
20: lpBuffer zeigt auf eine USER_INFO_20 Struktur
23: lpBuffer zeigt auf eine USER_INFO_23 Struktur

lpBuffer

[out] In dieser Long Variablen wird der Zeiger auf die Rückgabedaten gespeichert. Dieser Speicherbereich wird vom System allokiert und muss nach der Verwendung mittels NetApiBufferFree freigegeben werden. Die in dem Speicherbereich abgelegten Informationen richten sich nach dem im Parameter 'Level' angegebenen Wert. Zum Auslesen der in diesem Bereich abgelegten Informationen muss auf weitere API Funktionen wie z.B. RtlMoveMemory zurückgegriffen werden.
Rückgabe(n):

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

Beispiel:

nicht verfügbar

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: