ComputerPrincipal.FindByIdentity 方法

定义

命名空间:

System.DirectoryServices.AccountManagement

程序集:

System.DirectoryServices.AccountManagement.dll

包:

System.DirectoryServices.AccountManagement v8.0.0

返回一个与指定的标识值匹配的计算机主体对象。

重载

FindByIdentity(PrincipalContext, String)	返回一个与指定的标识值匹配的计算机主体对象。
FindByIdentity(PrincipalContext, IdentityType, String)	返回一个与指定的标识类型和值匹配的计算机主体对象。 此版本的 FindByIdentity 方法确定标识值的格式。

FindByIdentity(PrincipalContext, String)

Source:

Computer.cs

返回一个与指定的标识值匹配的计算机主体对象。

public:
 static System::DirectoryServices::AccountManagement::ComputerPrincipal ^ FindByIdentity(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::String ^ identityValue);

public static System.DirectoryServices.AccountManagement.ComputerPrincipal FindByIdentity (System.DirectoryServices.AccountManagement.PrincipalContext context, string identityValue);

static member FindByIdentity : System.DirectoryServices.AccountManagement.PrincipalContext * string -> System.DirectoryServices.AccountManagement.ComputerPrincipal

Public Shared Function FindByIdentity (context As PrincipalContext, identityValue As String) As ComputerPrincipal

参数

context

PrincipalContext

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

identityValue

String

计算机的标识。 此参数的格式可以是 IdentityType 枚举中包含的任何格式。

返回

ComputerPrincipal

与指定标识值相匹配的 ComputerPrincipal 对象，如果找不到匹配项，则为 null。

例外

MultipleMatchesException

找到与当前计算机对象匹配的多个计算机主体对象。

FindByIdentity(PrincipalContext, IdentityType, String)

Source:

Computer.cs

返回一个与指定的标识类型和值匹配的计算机主体对象。 此版本的 FindByIdentity 方法确定标识值的格式。

public:
 static System::DirectoryServices::AccountManagement::ComputerPrincipal ^ FindByIdentity(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::DirectoryServices::AccountManagement::IdentityType identityType, System::String ^ identityValue);

public static System.DirectoryServices.AccountManagement.ComputerPrincipal FindByIdentity (System.DirectoryServices.AccountManagement.PrincipalContext context, System.DirectoryServices.AccountManagement.IdentityType identityType, string identityValue);

static member FindByIdentity : System.DirectoryServices.AccountManagement.PrincipalContext * System.DirectoryServices.AccountManagement.IdentityType * string -> System.DirectoryServices.AccountManagement.ComputerPrincipal

Public Shared Function FindByIdentity (context As PrincipalContext, identityType As IdentityType, identityValue As String) As ComputerPrincipal

参数

context

PrincipalContext

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

identityType

IdentityType

IdentityType 枚举值，用于指定 identityValue 参数的格式。

identityValue

String

计算机的标识。 此参数的格式可以是 IdentityType 枚举中包含的任何格式。

返回

ComputerPrincipal

与指定标识值和类型相匹配的 ComputerPrincipal 对象；若未找到匹配，则为 null。

例外

MultipleMatchesException

找到与当前计算机对象匹配的多个计算机主体对象。

InvalidEnumArgumentException

该标识值不是有效的 IdentityType 枚举值。