Principal.GetGroups Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve uma coleção de objetos de grupo que especificam os grupos dos quais o principal atual pertence.
Sobrecargas
| Name | Description |
|---|---|
| GetGroups() |
Devolve uma coleção de objetos de grupo que especificam os grupos dos quais o principal atual pertence. |
| GetGroups(PrincipalContext) |
Devolve uma coleção de objetos de grupo dos quais o principal pertence e que existem no armazenamento fornecido pelo parâmetro de contexto especificado. |
Observações
Este método sobrecarregado só devolve os grupos dos quais o principal é membro direto; não são realizadas pesquisas recursivas. Os resultados de pesquisa recursiva estão disponíveis para objetos principais de utilizador. Para obter mais informações, consulte o método GetAuthorizationGroups.
Se a memória principal for AD DS, a lista de grupos contém o grupo primário do utilizador que é identificado pelo atributo principal do ID do grupo no objeto AD DS.
GetGroups()
- Origem:
- Principal.cs
- Origem:
- Principal.cs
- Origem:
- Principal.cs
- Origem:
- Principal.cs
Devolve uma coleção de objetos de grupo que especificam os grupos dos quais o principal atual pertence.
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)Devoluções
Uma coleção de GroupPrincipal objetos que especificam os grupos dos quais o principal atual pertence.
- Atributos
Observações
Este método retorna apenas os grupos dos quais o principal é diretamente membro; não são realizadas pesquisas recursivas. Os resultados de pesquisa recursiva estão disponíveis para objetos principais de utilizador. Para obter mais informações, consulte o método GetAuthorizationGroups.
Os grupos que são devolvidos por este método podem incluir grupos de um âmbito e armazenamento diferentes do principal. Por exemplo, se o principal for um objeto AD DS que tenha DN de "CN=SpecialGroups,DC=Fabrikam,DC=com, o conjunto devolvido pode conter grupos que pertencem ao "CN=NormalGroups,DC=Fabrikam,DC=com.
Se o principal atual for um principal AD DS, os grupos retornados incluem o grupo principal principal, conforme indicado pelo atributo "primaryGroupId" no objeto AD DS.
Ver também
Aplica-se a
GetGroups(PrincipalContext)
- Origem:
- Principal.cs
- Origem:
- Principal.cs
- Origem:
- Principal.cs
- Origem:
- Principal.cs
Devolve uma coleção de objetos de grupo dos quais o principal pertence e que existem no armazenamento 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 PrincipalContext objeto que especifica o contexto em que a consulta é realizada.
Quando o contexto está localizado noutro domínio, a consulta é realizada contra a representação dos objetos principais no contexto especificado.
Devoluções
Uma coleção de GroupPrincipal objetos que especificam os grupos dos quais o principal atual pertence.
- Atributos
Observações
Este método retorna apenas os grupos dos quais o principal é diretamente membro; não são realizadas pesquisas recursivas. Os resultados de pesquisa recursiva estão disponíveis para objetos principais de utilizador. Para obter mais informações, consulte o método GetAuthorizationGroups.
Os grupos que são devolvidos por este método podem incluir grupos de um âmbito e armazenamento diferentes do principal. Por exemplo, se o principal for um objeto AD DS que tenha DN de "CN=SpecialGroups,DC=Fabrikam,DC=com, o conjunto devolvido pode conter grupos que pertencem ao "CN=NormalGroups,DC=Fabrikam,DC=com.
Se o principal atual for um principal AD DS, os grupos devolvidos incluem o grupo primário dos principais, conforme indicado pelo atributo do ID do grupo primário no objeto AD DS.
