ComputerPrincipal.FindByIdentity ComputerPrincipal.FindByIdentity ComputerPrincipal.FindByIdentity ComputerPrincipal.FindByIdentity Method

Definition

Returns a computer principal object that matches the specified identity value.

Overloads

FindByIdentity(PrincipalContext, String) FindByIdentity(PrincipalContext, String) FindByIdentity(PrincipalContext, String) FindByIdentity(PrincipalContext, String)

Returns a computer principal object that matches the specified identity value.

FindByIdentity(PrincipalContext, IdentityType, String) FindByIdentity(PrincipalContext, IdentityType, String) FindByIdentity(PrincipalContext, IdentityType, String)

Returns a computer principal object that matches the specified identity type and value. This version of the FindByIdentity method determines the format of the identity value.

FindByIdentity(PrincipalContext, String) FindByIdentity(PrincipalContext, String) FindByIdentity(PrincipalContext, String) FindByIdentity(PrincipalContext, String)

Returns a computer principal object that matches the specified identity value.

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

Parameters

context
PrincipalContext PrincipalContext PrincipalContext PrincipalContext

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

identityValue
String String String String

The identity of the computer. This parameter can be any format that is contained in the IdentityType enumeration.

Returns

A ComputerPrincipal object that matches the specified identity value, or null if no matches are found.

Exceptions

Multiple computer principal objects matching the current computer object were found.

FindByIdentity(PrincipalContext, IdentityType, String) FindByIdentity(PrincipalContext, IdentityType, String) FindByIdentity(PrincipalContext, IdentityType, String)

Returns a computer principal object that matches the specified identity type and value. This version of the FindByIdentity method determines the format of the identity value.

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

Parameters

context
PrincipalContext PrincipalContext PrincipalContext PrincipalContext

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

identityType
IdentityType IdentityType IdentityType IdentityType

A IdentityType enumeration value that specifies the format of the identityValue parameter.

identityValue
String String String String

The identity of the computer. This parameter can be any format that is contained in the IdentityType enumeration.

Returns

A ComputerPrincipal object that matches the specified identity value and type, or null if no matches are found.

Exceptions

Multiple computer principal objects matching the current computer object were found.

Applies to