USER_INFO_1
The USER_INFO_1
structure specifies information about a user account.
typedef struct _USER_INFO_1 {
LPWSTR usri1_name;
LPWSTR usri1_password;
DWORD usri1_password_age;
DWORD usri1_priv;
LPWSTR usri1_home_dir;
LPWSTR usri1_comment;
DWORD usri1_flags;
LPWSTR usri1_script_path;
}USER_INFO_1, *PUSER_INFO_1, *LPUSER_INFO_1;
Members
usri1_name
Specifies the
name of the user account. For the NetUserSetInfo function, this member
is ignored.
usri1_password
The password
of the user specified in the usri1_name member. The length cannot exceed
PWLEN bytes. The NetUserEnum
and NetUserGetInfo
functions return a NULL pointer to maintain password security. By convention,
Windows NT limits the length of passwords to LM20_PWLEN characters. This
convention allows LAN Manager, Windows 3.x, Windows for Workgroups 3.x,
and Windows 95 clients to access a Windows NT server using the account.
usri1_password_age
Specifies the
number of seconds have elapsed since the usri1_password member was last
changed. The NetUserAdd
and NetUserSetInfo
functions ignore this member.
usri1_priv
One of three
values specifying the level of privilege assigned the usri1_name member.
For the NetUserAdd function, this member must be USER_PRIV_USER. For the
NetUserSetInfo function, this member must be the value returned from NetUserGetInfo
or NetUserEnum. This member can be one of the following values:
|
Value |
Meaning |
|
USER_PRIV_GUEST |
Guest |
|
USER_PRIV_USER |
User |
|
USER_PRIV_ADMIN |
Administrator |
usri1_home_dir
Points to a
Unicode string containing the path of the home directory for the user specified
in the user_name member. The string can be null.
usri1_comment
Points to a
Unicode string that contains a comment. This string can be a null string, or it
can have any number of characters before the terminating null character.
usri1_flags
Contains
values that determine several features. This member can be any of the following
values:
|
Value |
Meaning |
|
UF_SCRIPT |
The logon
script executed. This value must be set for LAN Manager 2.0 or Windows NT. |
|
UF_ACCOUNTDISABLE |
The user's
account is disabled. |
|
UF_HOMEDIR_REQUIRED |
The home
directory is required. This value is ignored in Windows NT. |
|
UF_PASSWRD_NOTREQD |
No password
is required. |
|
UF_PASSWRD_CANT_CHANGE
|
The user
cannot change the password. |
|
UF_LOCKOUT |
The account
is currently locked out. For NetUserSetInfo.UX_.U, this value can be cleared to unlock a
previously locked account. This value cannot be used to lock a previously
unlocked account. |
|
UF_DONT_EXPIRE_PASSWORD |
Represents
the password, which should never expire on the account. This value is valid
only for Windows NT. |
The following
values describe the account type. Only one value can be set. You cannot change
the account type using the NetUserSetInfo function.
|
Value |
Meaning |
|
UF_NORMAL_ACCOUNT |
This is a
default account type that represents a typical user. |
|
UF_TEMP_DUPLICATE_ACCOUNT |
This is an
account for users whose primary account is in another domain. This account
provides user access to this domain, but not to any domain that trusts this
domain. The User Manager refers to this account type as a local user
account. |
|
UF_WORKSTATION_TRUST_ACCOUNT |
This is a
computer account for an Windows NT Workstation or Windows NT Server that is a
member of this domain. |
|
UF_SERVER_TRUST_ACCOUNT |
This is a
computer account for an Windows NT Backup Domain Controller that is a member
of this domain. |
|
UF_INTERDOMAIN_TRUST_ACCOUNT |
This is a permit
to trust account for a Windows NT domain that trusts other
domains. |
usri1_script_path
Points to a
Unicode string specifying the path of the user's logon script, .CMD, .EXE, or
.BAT file. The string can be null.
See Also