struct user_info_1 {
  unsigned char                usri1_name[UNLEN+1];
  unsigned char                usri1_pad_1;
  unsigned char                usri1_password[ENCRYPTED_PWLEN];
  long                         usri1_password_age;
  unsigned short               usri1_priv;
  unsigned char LSFAR * LSPTR  usri1_home_dir;
  unsigned char LSFAR * LSPTR  usri1_comment;
  unsigned short               usri1_flags;
  unsigned char LSFAR * LSPTR  usri1_script_path;
};

where:

• The first field in this data structure is identical to that in the previous level.

• usri1_pad_1 word-aligns the data structure component.

• usri1_password is the password of usri1_name. The NetUserEnum and NetUserGetInfo APIs return a string of spaces to maintain password security. The string can be NULL. It can contain as many as PWLEN bytes, defined in NETCONS.H. The password should be uppercase.

• usri1_password_age indicates the number of seconds that have passed since usri1_password last changed. NetUserAdd and NetUserSetInfo calls ignore this element.

  To allow room for the encrypted version of the password to be transmitted over the network, the usri1_password field is longer than PWLEN bytes. When setting a user's password, check its length against PWLEN, not against ENCRYPTED_PWLEN.

• usri1_priv is one of three values indicating the level of privilege assigned usri1_name. The ACCESS.H header file defines these values as follows: ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
  ³ SYMBOLIC CONSTANT ³ VALUE ³ PRIVILEGE ³
  ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
  ³ USER_PRIV_GUEST ³ 0 ³ Guest (not supported in DSS) ³
  ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
  ³ USER_PRIV_USER ³ 1 ³ User ³
  ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
  ³ USER_PRIV_ADMIN ³ 2 ³ Administrator ³
  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
  

• usri1_home_dir points to an ASCIIZ string specifying the path to the user's home directory. (If this field or the string to which it points is null, no home directory is assigned for that user.) The home directory string must take one of the following forms:

  • A form that defines the drive of the user that will be assigned to the home directory. It can have as many as PATHLEN bytes.

    x:\machineID\y$\pathname
    

    where:

    --

    x is the drive letter to be assigned.
    --
    machineID is the name of the server that holds the home directory.
    --
    y is the drive letter on the server where the home directory exists.
    --
    pathname is the remaining path to the directory.
    -
    A form that defines a first-available drive specification for the name directory:

    \\machineID\y$\pathname

    where machineID, y, and pathname are defined as in the preceding form.
    To define a home directory at the root of a server's drive, omit \pathname from either of the forms previously described.

    Note: You also must create an access control profile to give users access to the home directory. See Access Permission Category for those APIs.

    
    usri1_comment points to an optional ASCIIZ string containing an optional comment or remark about the user. The string can be NULL, or can have as many as MAXCOMMENTSZ bytes before the terminating NULL character.
    
    usri1_flags determines whether a logon script is to be run and whether the user's account is enabled. The ACCESS.H header file defines the following possible values: ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
    ³ SYMBOLIC CONSTANT ³ BIT ³ MEANING ³
    ³ ³ MASK ³ ³
    ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
    ³ UF_SCRIPT ³ 0x1 ³ Must be 1. Logon script enabled. ³
    ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
    ³ UF_ACCOUNT_DISABLE ³ 0x2 ³ If 1, user's account disabled. ³
    ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
    ³ UF_DELETE_PROHIBITED ³ 0x4 ³ If 1, user's account cannot be ³
    ³ ³ ³ deleted. ³
    ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
    ³ UF_HOMEDIR_REQUIRED ³ 0x8 ³ If 1, home directory required. ³
    ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
    ³ UF_PASSWD_NOTREQD ³ 0x20 ³ If 1, password not required. (not sup- ³
    ³ ³ ³ ported in DSS) ³
    ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
    ³ UF_PASSWD_CANT_CHANGE ³ 0x40 ³ If 1, user cannot change password. ³
    ³ ³ ³ (not supported in DSS) ³
    ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
    
  • usri1_script_path points to an ASCIIZ string indicating the path name of the user's logon script (CMD, EXE, BAT or PRO file). If a file extension is not used, the file is assumed to have a CMD or BAT extension.

    The script path must be specified relative to the Netlogon service SCRIPTS path. It can have as many as PATHLEN bytes before the terminating NULL character. The constant PATHLEN is defined in the NETCONS.H header file. A null string indicates that no logon script exists.

  ---

  [Back] [Next]