ComputerPrincipal.FindByIdentity Método

Definição

Namespace:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Pacote:

System.DirectoryServices.AccountManagement v8.0.0

Retorna um objeto de entidade de segurança do computador que corresponde ao valor de identidade especificado.

Sobrecargas

FindByIdentity(PrincipalContext, String)	Retorna um objeto de entidade de segurança do computador que corresponde ao valor de identidade especificado.
FindByIdentity(PrincipalContext, IdentityType, String)	Retorna um objeto de entidade de segurança do computador que corresponde ao tipo de identidade e ao valor especificados. Essa versão do método FindByIdentity determina o formato do valor de identidade.

FindByIdentity(PrincipalContext, String)

Origem:

Computer.cs

Retorna um objeto de entidade de segurança do computador que corresponde ao valor de identidade especificado.

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

Parâmetros

context

PrincipalContext

O PrincipalContext que especifica o servidor ou domínio no qual as operações são executadas.

identityValue

String

A identidade do computador. Esse parâmetro pode estar em qualquer formato que esteja contido na enumeração IdentityType.

Retornos

ComputerPrincipal

Um objeto ComputerPrincipal que corresponde ao valor e ao tipo de identidade especificado, ou null, se nenhuma correspondência for encontrada.

Exceções

MultipleMatchesException

Foram encontrados vários objetos de entidade de segurança do computador que correspondem ao objeto de computador atual.

FindByIdentity(PrincipalContext, IdentityType, String)

Origem:

Computer.cs

Retorna um objeto de entidade de segurança do computador que corresponde ao tipo de identidade e ao valor especificados. Essa versão do método FindByIdentity determina o formato do valor de identidade.

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

Parâmetros

context

PrincipalContext

O PrincipalContext que especifica o servidor ou domínio no qual as operações são executadas.

identityType

IdentityType

Um valor de enumeração IdentityType que especifica o formato do parâmetro identityValue.

identityValue

String

A identidade do computador. Esse parâmetro pode estar em qualquer formato que esteja contido na enumeração IdentityType.

Retornos

ComputerPrincipal

Um objeto ComputerPrincipal que corresponde ao valor e ao tipo de identidade especificado, ou nulo, se nenhuma correspondência for encontrada.

Exceções

MultipleMatchesException

Foram encontrados vários objetos de entidade de segurança do computador que correspondem ao objeto de computador atual.

InvalidEnumArgumentException

O valor de identidade não é um valor de enumeração IdentityType válido.