AdvancedFilters.AccountLockoutTime(DateTime, MatchType) Method

Definition

Namespace:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Package:

System.DirectoryServices.AccountManagement v9.0.0

Source:

AdvancedFilters.cs

Sets the AccountLockoutTime query filter to the specified time and comparison type.

public:
 void AccountLockoutTime(DateTime lockoutTime, System::DirectoryServices::AccountManagement::MatchType match);

public void AccountLockoutTime (DateTime lockoutTime, System.DirectoryServices.AccountManagement.MatchType match);

member this.AccountLockoutTime : DateTime * System.DirectoryServices.AccountManagement.MatchType -> unit

Public Sub AccountLockoutTime (lockoutTime As DateTime, match As MatchType)

Parameters

lockoutTime

DateTime

A DateTime object.

match

MatchType

A MatchType that specifies how lockoutTime should be used in the comparison.

Examples

// Create the principal context for the usr object.
PrincipalContext ctx = new PrincipalContext(ContextType.Domain, "fabrikam.com", "CN=Users,DC=fabrikam,DC=com", "administrator", "SecurelyStoredPassword");

// Create the principal user object from the context
UserPrincipal usr = new UserPrincipal(ctx);

// Set the advanced query filter
usr.AdvancedSearchFilter.AccountLockoutTime(DateTime.Now.AddDays(-1), MatchType.GreaterThan);

// Create a PrincipalSearcher object.
PrincipalSearcher ps = new PrincipalSearcher(usr);

PrincipalSearchResult<Principal> results = ps.FindAll();

//Print user names of all accounts locked within the last 24 hours.

foreach (UserPrincipal u in results)
{
  Console.WriteLine(u.Name);
 }

Remarks

The time will default to UTC. If you want to specify the time in local time, then specify the Kind property of your DateTime object as DateTimeKind.Local.

See also

• PrincipalSearcher