BadPasswordCount Property, read only, User class

Description

The number of times the user tried to log on to the account using an incorrect password.

Syntax

vBadPasswordCount = User.BadPasswordCount

Returns

Long

Remarks

A value of -1 indicates that the value is unknown. This member is maintained separately on each Backup Domain Controller (BDC) in the domain. To get an accurate value, each BDC in the domain must be queried, and the largest value is used.

Examples

List of account logon info

  'Get UserManager.Server object
  Dim UM:Set UM = CreateObject("UserManager.Server")
  
  'Add a test user
  Dim User
  Set User = UM.Users.Add("~TestUser", "1TestPassword")

  Dim Out: Out = "Account logon info:" & vbCrLf
  Out = Out & toS("Account",20) & toS("Bad password", 15) & _
    toS("NumOfLogons", 15) & toS("LastLogon", 15) & vbCrLf

  For Each User In UM.Users
    Out = Out & toS(User.Name,20) & toS(User.BadPasswordCount,15) & _
      toS(User.NumOfLogons,15) & toS(User.LastLogon,15) & vbCrLf
  Next

  Wscript.Echo Out

  'Delete the test account
  UM.Users("~TestUser").Delete

  Function toS(byval W, Cols)
    W = "" & W: If W = "" Then W = "-"
    On Error Resume Next
    W = W & Space(Cols-Len(W))
    toS = W
  End Function

Methods of User class

AddToGroup, AddToLocalGroup, Delete, RemoveFromGroup, RemoveFromLocalGroup, UserAdd

Properties of User class

AuthFlags, BadPasswordCount, CodePage, Comment, CountryCode, Disabled, Expires, Flags, FullName, Groups, HomeDir, HomeDirDrive, ID, LastLogOff, LastLogon, LocalGroups, LockOut, LogonHours, MaxStorage, Name, NumOfLogons, Password, PasswordAge, PasswordCannotChange, PasswordExpired, PasswordNeverExpires, PasswordNotRequired, PrimaryGroupID, Privilege, Profile, Ras, ScriptPath, Server, UserComment, Workstations

UserManager.User

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

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.