GroupPrincipal.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 de grupo que corresponde ao valor de identidade especificado.

Sobrecargas

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

FindByIdentity(PrincipalContext, String)

Origem:

Group.cs

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

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

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

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

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

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 da entidade de segurança do grupo. Esse parâmetro pode estar em qualquer formato que esteja contido na enumeração IdentityType.

Retornos

GroupPrincipal

Um objeto GroupPrincipal 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 grupo que correspondem ao objeto de grupo atual.

FindByIdentity(PrincipalContext, IdentityType, String)

Origem:

Group.cs

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

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

public static System.DirectoryServices.AccountManagement.GroupPrincipal 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.GroupPrincipal

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

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 da entidade de segurança do grupo. Esse parâmetro pode estar em qualquer formato que esteja contido na enumeração IdentityType.

Retornos

GroupPrincipal

Um GroupPrincipal 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 grupo que correspondem ao objeto de grupo atual.

InvalidEnumArgumentException

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