USER_INFO_11-Struktur (lmaccess.h)
Die USER_INFO_11-Struktur enthält Informationen zu einem Benutzerkonto, einschließlich des Kontonamens, der Berechtigungsstufe, des Pfads zum Basisverzeichnis des Benutzers und anderer benutzerbezogener Netzwerkstatistiken.
Syntax
typedef struct _USER_INFO_11 {
LPWSTR usri11_name;
LPWSTR usri11_comment;
LPWSTR usri11_usr_comment;
LPWSTR usri11_full_name;
DWORD usri11_priv;
DWORD usri11_auth_flags;
DWORD usri11_password_age;
LPWSTR usri11_home_dir;
LPWSTR usri11_parms;
DWORD usri11_last_logon;
DWORD usri11_last_logoff;
DWORD usri11_bad_pw_count;
DWORD usri11_num_logons;
LPWSTR usri11_logon_server;
DWORD usri11_country_code;
LPWSTR usri11_workstations;
DWORD usri11_max_storage;
DWORD usri11_units_per_week;
PBYTE usri11_logon_hours;
DWORD usri11_code_page;
} USER_INFO_11, *PUSER_INFO_11, *LPUSER_INFO_11;
Member
usri11_name
Typ: LPWSTR
Ein Zeiger auf ein Unicode-Zeichen, das den Namen des Benutzerkontos angibt. Aufrufe der NetUserSetInfo-Funktion ignorieren diesen Member. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
usri11_comment
Typ: LPWSTR
Ein Zeiger auf eine Unicode-Zeichenfolge, die einen Kommentar enthält, der dem Benutzerkonto zugeordnet ist. Diese Zeichenfolge kann eine NULL-Zeichenfolge oder eine beliebige Anzahl von Zeichen vor dem beendenden NULL-Zeichen aufweisen.
usri11_usr_comment
Typ: LPWSTR
Ein Zeiger auf eine Unicode-Zeichenfolge, die einen Benutzerkommentar enthält. Diese Zeichenfolge kann eine NULL-Zeichenfolge oder eine beliebige Anzahl von Zeichen vor dem beendenden NULL-Zeichen aufweisen.
usri11_full_name
Typ: LPWSTR
Ein Zeiger auf eine Unicode-Zeichenfolge, die den vollständigen Namen des Benutzers enthält. Diese Zeichenfolge kann eine NULL-Zeichenfolge oder eine beliebige Anzahl von Zeichen vor dem beendenden NULL-Zeichen aufweisen.
usri11_priv
Art: DWORD
Die Berechtigungsebene, die dem usri11_name-Member zugewiesen ist. Für Aufrufe der NetUserAdd-Funktion muss dieser Member USER_PRIV_USER sein. Bei Aufrufen von NetUserSetInfo muss dieser Member der Wert sein, der von der NetUserGetInfo-Funktion oder der NetUserEnum-Funktion zurückgegeben wird. Dieser Member kann einer der folgenden Werte sein. Weitere Informationen zu Benutzer- und Gruppenkontorechten finden Sie unter Berechtigungen.
| Wert | Bedeutung |
|---|---|
|
Gast |
|
Benutzer |
|
Administrator |
usri11_auth_flags
Art: DWORD
Eine Reihe von Bitflags, die die Operatorberechtigungen des Benutzers definieren.
Aufrufe der NetUserGetInfo-Funktion und der NetUserEnum-Funktion geben einen Wert basierend auf der lokalen Gruppenmitgliedschaft des Benutzers zurück. Wenn der Benutzer Mitglied von Druckoperatoren ist, wird AF_OP_PRINT festgelegt. Wenn der Benutzer Mitglied von Serveroperatoren ist, wird AF_OP_SERVER festgelegt. Wenn der Benutzer Mitglied der Kontooperatoren ist, wird AF_OP_ACCOUNTS festgelegt. AF_OP_COMM wird nie festgelegt.
Die Funktionen NetUserAdd und NetUserSetInfo ignorieren diesen Member.
Es gelten folgende Einschränkungen:
- Wenn Sie die NetUserAdd-Funktion aufrufen, muss dieses Element 0 sein.
- Wenn Sie die NetUserSetInfo-Funktion aufrufen, muss dieser Member der Wert sein, der von einem Aufruf von NetUserGetInfo oder netUserEnum zurückgegeben wird.
usri11_password_age
Art: DWORD
Die Anzahl der Sekunden, die verstrichen sind, seit der usri11_password Member zuletzt geändert wurde. Die Funktionen NetUserAdd und NetUserSetInfo ignorieren diesen Member.
usri11_home_dir
Typ: LPWSTR
Ein Zeiger auf eine Unicode-Zeichenfolge, die den Pfad des Basisverzeichnisses für den im usri11_name-Element angegebenen Benutzer angibt. Die Zeichenfolge kann NULL sein.
usri11_parms
Typ: LPWSTR
Ein Zeiger auf eine Unicode-Zeichenfolge, die für die Verwendung durch Anwendungen reserviert ist. Diese Zeichenfolge kann eine NULL-Zeichenfolge oder eine beliebige Anzahl von Zeichen vor dem beendenden NULL-Zeichen aufweisen. Microsoft-Produkte verwenden dieses Element, um Benutzerkonfigurationsinformationen zu speichern. Ändern Sie diese Informationen nicht.
usri11_last_logon
Art: DWORD
Das Datum und die Uhrzeit der letzten Anmeldung. Dieser Wert wird als die Anzahl von Sekunden gespeichert, die seit 00:00:00, 1. Januar 1970 GMT verstrichen sind. Die Funktionen NetUserAdd und NetUserSetInfo ignorieren diesen Member.
Dieses Element wird auf jedem Sicherungsdomänencontroller (BDC) in der Domäne separat verwaltet. Um einen genauen Wert zu erhalten, müssen Sie jeden BDC in der Domäne abfragen. Die letzte Anmeldung erfolgte zu dem Zeitpunkt, der durch den größten abgerufenen Wert angegeben ist.
usri11_last_logoff
Art: DWORD
Dieser Member wird derzeit nicht verwendet.
Das Datum und die Uhrzeit der letzten Abmeldung. Dieser Wert wird als die Anzahl von Sekunden gespeichert, die seit 00:00:00, 1. Januar 1970 GMT verstrichen sind. Der Wert 0 gibt an, dass die letzte Abmeldungszeit unbekannt ist. Die NetUserAdd-Funktion und die NetUserSetInfo-Funktion ignorieren diesen Member.
Dieses Element wird auf jedem Sicherungsdomänencontroller (BDC) in der Domäne separat verwaltet. Um einen genauen Wert zu erhalten, müssen Sie jeden BDC in der Domäne abfragen. Die letzte Abmeldung erfolgte zu dem Zeitpunkt, der durch den größten abgerufenen Wert angegeben ist.
usri11_bad_pw_count
Art: DWORD
Die Anzahl der Benutzer, die versucht haben, sich mit einem falschen Kennwort bei diesem Konto anzumelden. Der Wert –1 gibt an, dass der Wert unbekannt ist. Die Funktionen NetUserAdd und NetUserSetInfo ignorieren diesen Member.
Dieses Element wird vom primären Domänencontroller (PDC) repliziert. Sie wird auch auf jedem Sicherungsdomänencontroller (BDC) in der Domäne verwaltet. Um einen genauen Wert zu erhalten, müssen Sie jeden BDC in der Domäne abfragen. Die Anzahl der Benutzer, die versucht haben, sich mit einem falschen Kennwort anzumelden, ist der größte abgerufene Wert.
usri11_num_logons
Art: DWORD
Die Anzahl der Erfolgreichen Anmeldungen des Benutzers bei diesem Konto. Der Wert –1 gibt an, dass der Wert unbekannt ist. Aufrufe der Funktionen NetUserAdd und NetUserSetInfo ignorieren diesen Member.
Dieses Element wird auf jedem Sicherungsdomänencontroller (BDC) in der Domäne separat verwaltet. Um einen genauen Wert zu erhalten, müssen Sie jeden BDC in der Domäne abfragen. Die Anzahl der erfolgreichen Anmeldungen des Benutzers ist die Summe der abgerufenen Werte.
usri11_logon_server
Typ: LPWSTR
Ein Zeiger auf eine Unicode-Zeichenfolge, die den Namen des Servers enthält, an den Anmeldeanforderungen gesendet werden. Servernamen sollten zwei umgekehrte Schrägstriche (\) vorangestellt werden. Um anzugeben, dass die Anmeldeanforderung von jedem Anmeldeserver verarbeitet werden kann, geben Sie ein Sternchen (\*) für den Servernamen an. Eine NULL-Zeichenfolge gibt an, dass Anforderungen an den Domänencontroller gesendet werden sollen.
Für Windows-Server geben NetUserGetInfo und NetUserEnum \* zurück. Die Funktionen NetUserAdd und NetUserSetInfo ignorieren diesen Member.
usri11_country_code
Art: DWORD
Der Länder-/Regionscode für die Sprache der Wahl des Benutzers.
usri11_workstations
Typ: LPWSTR
Ein Zeiger auf eine Unicode-Zeichenfolge, die die Namen von Arbeitsstationen enthält, von denen sich der Benutzer anmelden kann. Es können bis zu acht Arbeitsstationen angegeben werden; Die Namen müssen durch Kommas getrennt werden. Eine NULL-Zeichenfolge gibt an, dass es keine Einschränkung gibt. Um Anmeldungen von allen Arbeitsstationen bei diesem Konto zu deaktivieren, legen Sie den UF_ACCOUNTDISABLE-Wert im usri11_flags-Member fest.
usri11_max_storage
Art: DWORD
Der maximale Speicherplatz, den der Benutzer verwenden kann. Geben Sie USER_MAXSTORAGE_UNLIMITED an, um den gesamten verfügbaren Speicherplatz zu verwenden.
usri11_units_per_week
Art: DWORD
Die Anzahl gleich langer Zeiteinheiten, in die die Woche unterteilt wird. Dieser Wert ist erforderlich, um die Länge der Bitzeichenfolge im usri11_logon_hours-Member zu berechnen.
Dieser Member muss für LAN Manager 2.0 UNITS_PER_WEEK werden. Dieses Element wird von den Funktionen NetUserAdd und NetUserSetInfo ignoriert.
Für Dienstanwendungen müssen die Einheiten einen der folgenden Werte aufweisen: SAM_DAYS_PER_WEEK, SAM_HOURS_PER_WEEK oder SAM_MINUTES_PER_WEEK.
usri11_logon_hours
Typ: PBYTE
Ein Zeiger auf eine 21-Byte(168 Bit)-Bitzeichenfolge, die die Zeiten angibt, zu denen sich der Benutzer anmelden kann. Jedes Bit stellt eine eindeutige Stunde in der Woche in Greenwich Mean Time (GMT) dar.
Das erste Bit (Bit 0, Wort 0) ist Sonntag, 0:00 bis 0:59; das zweite Bit (Bit 1, Wort 0) ist Sonntag, 1:00 bis 1:59; Und so weiter. Beachten Sie, dass Bit 0 in Wort 0 nur dann den Sonntag von 0:00 bis 0:59 Uhr darstellt, wenn Sie sich in der GMT-Zeitzone befinden. In allen anderen Fällen müssen Sie die Bits entsprechend Ihrem Zeitzonenoffset anpassen (z. B. GMT minus 8 Stunden für Pacific Standard Time).
Geben Sie einen NULL-Zeiger in diesem Member an, wenn Sie die NetUserAdd-Funktion aufrufen, um keine Zeiteinschränkung anzugeben. Geben Sie beim Aufrufen der NetUserSetInfo-Funktion einen NULL-Zeiger an, um anzugeben, dass keine Änderung an den Zeiten vorgenommen werden soll, in denen sich der Benutzer anmelden kann.
usri11_code_page
Art: DWORD
Die Codepage für die Sprache der Wahl des Benutzers.
Hinweise
Benutzerkontennamen sind auf 20 Zeichen und Gruppennamen auf 256 Zeichen beschränkt. Darüber hinaus können Kontonamen nicht durch einen Punkt beendet werden, und sie dürfen keine Kommas oder eines der folgenden druckbaren Zeichen enthalten: ", /, , [, ], ], :, |, <, , >+, =, ;, ?, *. Namen können auch keine Zeichen im Bereich 1 bis 31 enthalten, die nicht druckbar sind.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Kopfzeile | lmaccess.h (lm.h einschließen) |