UserPrincipal.GetAuthorizationGroups Metoda

Definicja

Przestrzeń nazw:

System.DirectoryServices.AccountManagement

Zestaw:

System.DirectoryServices.AccountManagement.dll

Pakiet:

System.DirectoryServices.AccountManagement v8.0.0

Źródło:

User.cs

Zwraca kolekcję obiektów głównych, które zawierają wszystkie grupy autoryzacji, których ten użytkownik jest członkiem. Ta funkcja zwraca tylko grupy, które są grupami zabezpieczeń; grupy dystrybucyjne nie są zwracane.

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)

Zwraca

PrincipalSearchResult<Principal>

Kolekcja Principal obiektów, które zawierają grupy, których użytkownik jest członkiem, lub null, jeśli użytkownik nie należy do żadnych grup zabezpieczeń.

Wyjątki

PrincipalOperationException

Próba pobrania grup autoryzacji nie powiodła się.

NotSupportedException

Pobieranie grup autoryzacji nie jest obsługiwane przez ten system operacyjny.

Uwagi

Ta metoda wyszukuje wszystkie grupy rekursywnie i zwraca grupy, w których użytkownik jest członkiem. Zwrócony zestaw może również zawierać dodatkowe grupy, które system rozważyłby użytkownika jako członka do celów autoryzacji.

Grupy zwracane przez tę metodę mogą obejmować grupy z innego zakresu i magazynu niż podmiot zabezpieczeń. Jeśli na przykład podmiot zabezpieczeń jest obiektem usług AD DS, który ma nazwę DN "CN=SpecialGroups,DC=Fabrikam,DC=com, zwrócony zestaw może zawierać grupy należące do "CN=NormalGroups,DC=Fabrikam,DC=com.