Principal.GetGroups Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- Origem:
- Principal.cs
- 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 ();[System.Security.SecurityCritical]
public System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal> GetGroups ();member this.GetGroups : unit -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal>[<System.Security.SecurityCritical>]
member this.GetGroups : unit -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal>Public Function GetGroups () As PrincipalSearchResult(Of Principal)Retornos
Uma coleção de objetos GroupPrincipal que especificam os grupos dos quais a entidade atual é membro.
- Atributos
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
Aplica-se a
GetGroups(PrincipalContext)
- Origem:
- Principal.cs
- Origem:
- Principal.cs
- 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);[System.Security.SecurityCritical]
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>[<System.Security.SecurityCritical>]
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
Uma coleção de objetos GroupPrincipal que especificam os grupos dos quais a entidade atual é membro.
- Atributos
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.
