Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

AuthenticablePrincipal.FindByBadPasswordAttempt Method (PrincipalContext, DateTime, MatchType)

Returns a collection of authentication principal objects that have an incorrect password try recorded in the specified date and time range.

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

public static PrincipalSearchResult<AuthenticablePrincipal> FindByBadPasswordAttempt(
	PrincipalContext context,
	DateTime time,
	MatchType type
)

Parameters

context
Type: System.DirectoryServices.AccountManagement.PrincipalContext

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

time
Type: System.DateTime

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

type
Type: System.DirectoryServices.AccountManagement.MatchType

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

Return Value

Type: System.DirectoryServices.AccountManagement.PrincipalSearchResult<AuthenticablePrincipal>
A [T:System.DirectoryServices.AccountManagement.PrincipalSearchResult'1] that contains one or more AuthenticablePrincipal objects, or an empty collection if no results are found.

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 Local.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5

.NET Framework Client Profile

Supported in: 4
Show:
© 2015 Microsoft