USER_INFO_20 structure

The USER_INFO_20 structure contains information about a user account, including the account name, the user's full name, a comment associated with the account, and the user's relative ID (RID).

Note  

The USER_INFO_23 structure supersedes the USER_INFO_20 structure. It is recommended that applications use the USER_INFO_23 structure instead of the USER_INFO_20 structure.

 

Syntax


typedef struct _USER_INFO_20 {
  LPWSTR usri20_name;
  LPWSTR usri20_full_name;
  LPWSTR usri20_comment;
  DWORD  usri20_flags;
  DWORD  usri20_user_id;
} USER_INFO_20, *PUSER_INFO_20, *LPUSER_INFO_20;

Members

usri20_name

Type: LPWSTR

A pointer to a Unicode string that specifies the name of the user account. Calls to the NetUserSetInfo function ignore this member. For more information, see the following Remarks section.

usri20_full_name

Type: LPWSTR

A pointer to a Unicode string that contains the full name of the user. This string can be a null string, or it can have any number of characters before the terminating null character.

usri20_comment

Type: LPWSTR

A pointer to a Unicode string that contains a comment associated with the user account. This string can be a null string, or it can have any number of characters before the terminating null character.

usri20_flags

Type: DWORD

This member can be one or more of the following values. Note that setting user account control flags may require certain privileges and control access rights. For more information, see the Remarks section of the NetUserSetInfo function.

ValueMeaning
UF_SCRIPT

The logon script executed. This value must be set.

UF_ACCOUNTDISABLE

The user's account is disabled.

UF_HOMEDIR_REQUIRED

The home directory is required. This value is ignored.

UF_PASSWD_NOTREQD

No password is required.

UF_PASSWD_CANT_CHANGE

The user cannot change the password.

UF_LOCKOUT

The account is currently locked out. You can call the NetUserSetInfo function to clear this value and unlock a previously locked account. You cannot use this value to lock a previously unlocked account.

UF_DONT_EXPIRE_PASSWD

The password should never expire on the account.

UF_ENCRYPTED_TEXT_PASSWORD_ALLOWED

The user's password is stored under reversible encryption in the Active Directory.

UF_NOT_DELEGATED

Marks the account as "sensitive"; other users cannot act as delegates of this user account.

UF_SMARTCARD_REQUIRED

Requires the user to log on to the user account with a smart card.

UF_USE_DES_KEY_ONLY

Restrict this principal to use only Data Encryption Standard (DES) encryption types for keys.

UF_DONT_REQUIRE_PREAUTH

This account does not require Kerberos preauthentication for logon.

UF_TRUSTED_FOR_DELEGATION

The account is enabled for delegation. This is a security-sensitive setting; accounts with this option enabled should be tightly controlled. This setting allows a service running under the account to assume a client's identity and authenticate as that user to other remote servers on the network.

UF_PASSWORD_EXPIRED

The user's password has expired.

Windows 2000:  This value is not supported.

UF_TRUSTED_TO_AUTHENTICATE_FOR_DELEGATION

The account is trusted to authenticate a user outside of the Kerberos security package and delegate that user through constrained delegation. This is a security-sensitive setting; accounts with this option enabled should be tightly controlled. This setting allows a service running under the account to assert a client's identity and authenticate as that user to specifically configured services on the network.

Windows XP/2000:  This value is not supported.

 

The following values describe the account type. Only one value can be set. You cannot change the account type using the NetUserSetInfo function.

ValueMeaning
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 a computer that is a member of this domain.

UF_SERVER_TRUST_ACCOUNT

This is a computer account for a backup domain controller that is a member of this domain.

UF_INTERDOMAIN_TRUST_ACCOUNT

This is a permit to trust account for a domain that trusts other domains.

 

usri20_user_id

Type: DWORD

The user's relative identifier (RID). The RID is determined by the Security Account Manager (SAM) when the user is created. It uniquely defines this user account to SAM within the domain. The NetUserAdd and NetUserSetInfo functions ignore this member. For more information about RIDs, see SID Components.

Remarks

User account names are limited to 20 characters and group names are limited to 256 characters. In addition, account names cannot be terminated by a period and they cannot include commas or any of the following printable characters: ", /, \, [, ], :, |, <, >, +, =, ;, ?, *. Names also cannot include characters in the range 1-31, which are nonprintable.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Lmaccess.h (include Lm.h)

See also

Network Management Overview
Network Management Structures
User Functions
NetUserAdd
NetUserEnum
NetUserSetInfo

 

 

Show: