Principal.GetGroups Método

Definição

Namespace:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Pacote:

System.DirectoryServices.AccountManagement v8.0.0

Retorna uma coleção de objetos de grupo que especificam os grupos dos quais a entidade atual é membro.

Sobrecargas

GetGroups()	Retorna uma coleção de objetos de grupo que especificam os grupos dos quais a entidade atual é membro.
GetGroups(PrincipalContext)	Retorna uma coleção de objetos de grupo da qual a entidade de segurança é um membro e que existe no repositório fornecido pelo parâmetro de contexto especificado.

Comentários

Esse método sobrecarregado retorna apenas os grupos dos quais a entidade de segurança é diretamente um membro; nenhuma pesquisa recursiva é executada. Os resultados da pesquisa recursiva estão disponíveis para objetos de entidade de segurança do usuário. Para obter mais informações, consulte o método GetAuthorizationGroups.

Se o repositório principal for AD DS, a lista de grupos conterá o grupo primário do usuário identificado pelo atributo ID do grupo primário no objeto do AD DS.

GetGroups()

Origem:

Principal.cs

Retorna uma coleção de objetos de grupo que especificam os grupos dos quais a entidade atual é membro.

public:
 System::DirectoryServices::AccountManagement::PrincipalSearchResult<System::DirectoryServices::AccountManagement::Principal ^> ^ GetGroups();

public System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal> GetGroups ();

member this.GetGroups : unit -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal>

Public Function GetGroups () As PrincipalSearchResult(Of Principal)

Retornos

PrincipalSearchResult<Principal>

Uma coleção de objetos GroupPrincipal que especificam os grupos dos quais a entidade atual é membro.

Comentários

Esse método retorna apenas os grupos dos quais a entidade de segurança é diretamente um membro; nenhuma pesquisa recursiva é executada. Os resultados da pesquisa recursiva estão disponíveis para objetos de entidade de segurança do usuário. Para obter mais informações, consulte o método GetAuthorizationGroups.

Os grupos retornados por esse método podem incluir grupos de um escopo e repositório diferentes do principal. Por exemplo, se a entidade de segurança for um objeto AD DS que tenha um DN de "CN=SpecialGroups,DC=Fabrikam,DC=com, o conjunto retornado poderá conter grupos que pertencem a "CN=NormalGroups,DC=Fabrikam,DC=com.

Se a entidade de segurança atual for uma entidade de segurança do AD DS, os grupos retornados incluirão o grupo primário de entidades de segurança, conforme indicado pelo atributo "primaryGroupId" no objeto AD DS.

Confira também

• GetGroups()

GetGroups(PrincipalContext)

Origem:

Principal.cs

Retorna uma coleção de objetos de grupo da qual a entidade de segurança é um membro e que existe no repositório fornecido pelo parâmetro de contexto especificado.

public:
 System::DirectoryServices::AccountManagement::PrincipalSearchResult<System::DirectoryServices::AccountManagement::Principal ^> ^ GetGroups(System::DirectoryServices::AccountManagement::PrincipalContext ^ contextToQuery);

public System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal> GetGroups (System.DirectoryServices.AccountManagement.PrincipalContext contextToQuery);

member this.GetGroups : System.DirectoryServices.AccountManagement.PrincipalContext -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal>

Public Function GetGroups (contextToQuery As PrincipalContext) As PrincipalSearchResult(Of Principal)

Parâmetros

contextToQuery

PrincipalContext

O objeto PrincipalContext que especifica o contexto no qual a consulta é realizada.

Quando o contexto está localizado em outro domínio, a consulta é realizada na representação dos objetos da entidade de segurança no contexto especificado.

Retornos

PrincipalSearchResult<Principal>

Uma coleção de objetos GroupPrincipal que especificam os grupos dos quais a entidade atual é membro.

Comentários

Esse método retorna apenas os grupos dos quais a entidade de segurança é diretamente um membro; nenhuma pesquisa recursiva é executada. Os resultados da pesquisa recursiva estão disponíveis para objetos de entidade de segurança do usuário. Para obter mais informações, consulte o método GetAuthorizationGroups.

Os grupos retornados por esse método podem incluir grupos de um escopo e repositório diferentes do principal. Por exemplo, se a entidade de segurança for um objeto AD DS que tenha um DN de "CN=SpecialGroups,DC=Fabrikam,DC=com, o conjunto retornado poderá conter grupos que pertencem a "CN=NormalGroups,DC=Fabrikam,DC=com.

Se a entidade de segurança atual for uma entidade de segurança do AD DS, os grupos retornados incluirão o grupo primário de entidades de segurança, conforme indicado pelo atributo ID do grupo primário no objeto do AD DS.

Confira também

• GetGroups()