Compartilhar via


UserPrincipal.GetAuthorizationGroups Método

Definição

Retorna uma coleção de objetos de entidade de segurança que contém todos os grupos de autorização de que o usuário é membro. Essa função retorna apenas grupos de segurança; grupos de distribuição não são retornados.

public:
 System::DirectoryServices::AccountManagement::PrincipalSearchResult<System::DirectoryServices::AccountManagement::Principal ^> ^ GetAuthorizationGroups();
public System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal> GetAuthorizationGroups ();
member this.GetAuthorizationGroups : unit -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal>
Public Function GetAuthorizationGroups () As PrincipalSearchResult(Of Principal)

Retornos

Uma coleção de Principal objetos que contêm os grupos dos quais o usuário é membro ou nulo se o usuário não pertence a nenhum grupo de segurança.

Exceções

Falha ao tentar recuperar os grupos de autorização.

Esse sistema operacional não dá suporte à recuperação de grupos de autorização.

Comentários

Esse método pesquisa todos os grupos recursivamente e retorna os grupos nos quais o usuário é membro. O conjunto retornado também pode incluir grupos adicionais dos quais o sistema consideraria o usuário um membro para fins de autorização.

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 do 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.

Aplica-se a