AuthenticablePrincipal.FindByLogonTime Method (PrincipalContext, DateTime, MatchType)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Returns a collection of authentication principal objects that have an account logon recorded in the specified date and time range.

Namespace:   System.DirectoryServices.AccountManagement
Assembly:  System.DirectoryServices.AccountManagement (in System.DirectoryServices.AccountManagement.dll)

static member FindByLogonTime : 
        context:PrincipalContext *
        time:DateTime *
        type:MatchType -> PrincipalSearchResult<AuthenticablePrincipal>


Type: System.DirectoryServices.AccountManagement.PrincipalContext

The PrincipalContext that specifies the server or domain against which operations are performed.

Type: System.DateTime

A DateTime object that identifies the date and time of the logon record. This parameter is used with the type parameter to determine the range of time in which the returned objects have an account logon recorded.

Type: System.DirectoryServices.AccountManagement.MatchType

A MatchType enumeration value that specifies the type of match that is applied to the time parameter.

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

The following code connects to the ADAM instance hosted by the server "" on port number "5000." The username (adamAdmin), and password (SecretPwd123) are specified in the PrincipalContext constructor.

A search is performed for all authenticable principals under the container "DC=adamApp1,DC=fabrikam,DC=com" that have not logged on to this ADAM instance for the last 45 days. The principals returned by the search are then deleted.

PrincipalContext ctx = new PrincipalContext(
                                      "adamAdmin", "SecretPwd123");

PrincipalSearchResult<AuthenticablePrincipal> oldPrincipals = 
                            (DateTime.Now - new TimeSpan(45, 0, 0, 0)), 

foreach (Principal p in oldPrincipals)


.NET Framework
Available since 3.5
Return to top