User Class

Description

Properties of the user account, and methods for creating, deleting and selecting users.

Object model

User - Properties of the user account, and methods for creating, deleting and selecting users. (Item property, Returns one group member.)

RasUser - RAS privileges and call-back phone number for the user. (Ras property, Enables setting of the RAS privileges and call-back phone number for the user.)

Groups - Contains methods and properties for enumerating groups. (Groups property, Get a list of groups that an NT user belongs to .)

Groups - Contains methods and properties for enumerating groups. (LocalGroups property, List of local groups to which a specified user belongs.)

Methods

AddToGroup		Gives the user account membership in an existing global group.
AddToLocalGroup		Adds the user to an existing local group.
Delete		Deletes the user account.
RemoveFromGroup		Removes the user from a particular global group in the security database.
RemoveFromLocalGroup		Removes the user from an existing local group.
UserAdd		Adds a user account and assigns a password and privilege level.

Properties

AuthFlags	The user's operator privileges.
OperatorPrivileges, RW
CodePage	The code page for the user's language of choice.
Long, RW
Comment	Comment for the user.
String, RW
CountryCode	The country code for the user's language of choice.
Long, RW
Disabled	The user's account is disabled.
Boolean, RW
Expires	Specifies when the account will expire.
Date, RW
Flags	Contains values that determine several features. This member can be any of the UserFlags values.
UserFlags, RW
FullName	The full name is the user's complete name.
String, RW
HomeDir	Contains the path of the home directory of the user.
String, RW
HomeDirDrive	Specifies the drive letter assigned to the user’s home directory for logon purposes.
String, RW
LockOut	The account is currently locked out. This value can be cleared to unlock a previously locked account. This value cannot be used to lock a previously unlocked account.
Boolean, RW
LogonHours	Specifies the times during which the user can log on.
Boolean, RW
MaxStorage	Specifies the maximum amount of disk space the user can use. Use the value specified in umMAXSTORAGE_UNLIMITED to use all available disk space.
Long, RW
Name	Specifies the name of the user account.
String, RW
PasswordCannotChange	The user cannot change the password.
Boolean, RW
PasswordExpired	Determines whether the password of the user has expired.
Boolean, RW
PasswordNeverExpires	Represents the password, which should never expire on the account. This value is valid only for Windows NT.
Boolean, RW
PasswordNotRequired	No password is required.
Boolean, RW
PrimaryGroupID	Specifies the relative ID (RID) of the Primary Global Group for this user.
Long, RW
Profile	Specifies a path to the user’s profile. This value can be a null string, a local absolute path, or a UNC path.
String, RW
ScriptPath	Specifying the path of the user's logon script, .CMD, .EXE, or .BAT file.
String, RW
UserComment	Contains a user comment for the account.
String, RW
Workstations	Workstations from which the user can log on. As many as eight workstations can be specified; the names must be separated by commas (,). A null string indicates that there is no restriction.
String, RW
BadPasswordCount	The number of times the user tried to log on to the account using an incorrect password.
Long, RO
Groups	Get a list of groups that an NT user belongs to .
Groups, RO
ID	ID of the user.
Long, RO
LastLogOff	Specifies when the last logoff occurred.
Date, RO
LastLogon	Specifies when the last logon occurred.
Date, RO
LocalGroups	List of local groups to which a specified user belongs.
Groups, RO
NumOfLogons	The number of successful times the user tried to log on to this account.
Long, RO
PasswordAge	Specifies the time have elapsed since the password was last changed.
Date, RO
Privilege	One of three values specifying the level of privilege.
UserPrivileges, RO
Ras	Enables setting of the RAS privileges and call-back phone number for the user.
RasUser, RO
Server	The remote server within the user account.
Server, RO
Password	Specifies the password of the user account
String, WO

Examples

Unlock account

Dim Server

Set Server = CreateObject("UserManager.Server")
'Unlock one user account
Server.Users("Coll").LockOut = False

'Unlock all user accounts 
For Each User In Server.Users
    User.LockOut = False
Next

Change comment

Dim Server

Set Server = CreateObject("UserManager.Server")
Server.Users("Coll").Comment = "Power user"

Used in

Users.Item, Users.Add, oFormField.Value

ActiveX UserManager classes

User, Users, Group, Server, Groups, GroupMembers, RasUser, Servers, Domain

ActiveX UserManager enums

UsersFilter, GroupAttributes, UserFlags, UserPrivileges, ServerTypes, LogonTypes, LogonProviders, OperatorPrivileges, RasPrivileges, SIDNameUse

UserManager

Easy to use classes to create, delete and manage local and remote user accounts, groups, servers and domains in the Windows NT (2000/XP) environment. Simple work with user accounts and groups from VBA, VBS/JS, ASP and T-SQL.