UserPrincipal.GetAuthorizationGroups Método

Definição

Namespace:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Pacote:

System.DirectoryServices.AccountManagement v8.0.0

Origem:

User.cs

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

PrincipalSearchResult<Principal>

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

PrincipalOperationException

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

NotSupportedException

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.