AdvancedFilters.AccountLockoutTime(DateTime, MatchType) Method

Reference

Definition

Namespace:: System.DirectoryServices.AccountManagement

Assembly:: System.DirectoryServices.AccountManagement.dll

Package:: System.DirectoryServices.AccountManagement v9.0.0

Source:: AdvancedFilters.cs

Source:: AdvancedFilters.cs

Source:: AdvancedFilters.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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.

Applies to

Jaa