AuthenticablePrincipal.FindByLogonTime 方法

定义

命名空间:

System.DirectoryServices.AccountManagement

程序集:

System.DirectoryServices.AccountManagement.dll

包:

System.DirectoryServices.AccountManagement v8.0.0

重载

FindByLogonTime(PrincipalContext, DateTime, MatchType)	返回身份验证主体对象的集合，这些对象在指定日期和时间范围内记录帐户登录。
FindByLogonTime<T>(PrincipalContext, DateTime, MatchType)	返回一个对象 PrincipalSearchResult<T> 集合，对象在指定的日期和时间范围内有登录时间。 这是想要实现此功能的扩展类的模板函数。

FindByLogonTime(PrincipalContext, DateTime, MatchType)

Source:

AuthenticablePrincipal.cs

返回身份验证主体对象的集合，这些对象在指定日期和时间范围内记录帐户登录。

public:
 static System::DirectoryServices::AccountManagement::PrincipalSearchResult<System::DirectoryServices::AccountManagement::AuthenticablePrincipal ^> ^ FindByLogonTime(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, DateTime time, System::DirectoryServices::AccountManagement::MatchType type);

public static System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.AuthenticablePrincipal> FindByLogonTime (System.DirectoryServices.AccountManagement.PrincipalContext context, DateTime time, System.DirectoryServices.AccountManagement.MatchType type);

static member FindByLogonTime : System.DirectoryServices.AccountManagement.PrincipalContext * DateTime * System.DirectoryServices.AccountManagement.MatchType -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.AuthenticablePrincipal>

Public Shared Function FindByLogonTime (context As PrincipalContext, time As DateTime, type As MatchType) As PrincipalSearchResult(Of AuthenticablePrincipal)

参数

context

PrincipalContext

PrincipalContext，用于指定要对其执行操作的服务器或域。

time

DateTime

用于标识登录记录的日期和时间的 DateTime 对象。 此参数与类型参数共同确定一个时间范围，返回的对象会在此时间范围内记录帐户登录。

type

MatchType

MatchType 枚举值，用于指定应用到 time 参数的匹配类型。

返回

PrincipalSearchResult<AuthenticablePrincipal>

一个 PrincipalSearchResult<T>，它包含一个或多个 AuthenticablePrincipal 对象。

示例

以下代码连接到服务器“adamHost1.fabrikam.com”在端口号“5000”上托管的 ADAM 实例。在构造函数中 PrincipalContext 指定用户名 (adamAdmin) ，密码 (SecretPwd123) 。

对于过去 45 天内未登录到此 ADAM 实例的容器“DC=adamApp1，DC=fabrikam，DC=com”下的所有可验证主体，将执行搜索。 然后，将删除搜索返回的主体。

PrincipalContext ctx = new PrincipalContext(  
                                      ContextType.ApplicationDirectory,   
                                      "adamHost1.fabrikam.com:5000",   
                                      "DC=adamApp1,DC=fabrikam,DC=com",   
                                      "adamAdmin", "SecretPwd123");  

PrincipalSearchResult<AuthenticablePrincipal> oldPrincipals =   
                     AuthenticablePrincipal.FindByLogonTime(ctx,   
                            (DateTime.Now - new TimeSpan(45, 0, 0, 0)),   
                            MatchType.LessThan);  

foreach (Principal p in oldPrincipals)  
{  
    p.Delete();  
}  

oldPrincipals.Dispose();  
ctx.Dispose();  

注解

时间默认为 UTC。 如果要以本地时间指定时间，请将 对象的 属性time指定Kind为 DateTimeKind.Local。

FindByLogonTime<T>(PrincipalContext, DateTime, MatchType)

Source:

AuthenticablePrincipal.cs

返回一个对象 PrincipalSearchResult<T> 集合，对象在指定的日期和时间范围内有登录时间。 这是想要实现此功能的扩展类的模板函数。

protected:
generic <typename T>
 static System::DirectoryServices::AccountManagement::PrincipalSearchResult<T> ^ FindByLogonTime(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, DateTime time, System::DirectoryServices::AccountManagement::MatchType type);

protected static System.DirectoryServices.AccountManagement.PrincipalSearchResult<T> FindByLogonTime<T> (System.DirectoryServices.AccountManagement.PrincipalContext context, DateTime time, System.DirectoryServices.AccountManagement.MatchType type);

static member FindByLogonTime : System.DirectoryServices.AccountManagement.PrincipalContext * DateTime * System.DirectoryServices.AccountManagement.MatchType -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<'T>

Protected Shared Function FindByLogonTime(Of T) (context As PrincipalContext, time As DateTime, type As MatchType) As PrincipalSearchResult(Of T)

类型参数

T

参数

context

PrincipalContext

PrincipalContext，用于指定要对其执行操作的服务器或域。

time

DateTime

DateTime 对象，用于标识密码设置的日期和时间。 此参数与类型参数共同使用可确定记录返回对象密码设置的时间范围。

type

MatchType

MatchType 枚举值，用于指定应用到 time 参数的匹配类型。

返回

PrincipalSearchResult<T>

含有一个或多个相应主体类型的 PrincipalSearchResult<T>；如果未找到匹配，则为空集合。

注解

时间默认为 UTC。 如果要以本地时间指定时间，请将 对象的 属性time指定Kind为 DateTimeKind.Local。