UserPrincipal.GetAuthorizationGroups Methode

Definition

Namespace:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Paket:

System.DirectoryServices.AccountManagement v8.0.0

Quelle:

User.cs

Gibt eine Sammlung von Prinzipalobjekten zurück, die alle Autorisierungsgruppen enthält, in denen dieser Benutzer Member ist. Diese Funktion gibt nur Gruppen zurück, die Sicherheitsgruppen sind; Verteilergruppen werden nicht zurückgegeben.

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)

Gibt zurück

PrincipalSearchResult<Principal>

Eine Auflistung von Principal Objekten, die die Gruppen enthalten, deren Mitglied der Benutzer ist, oder NULL, wenn der Benutzer keiner Sicherheitsgruppe angehört.

Ausnahmen

PrincipalOperationException

Fehler bei dem Versuch, Autorisierungsgruppen abzurufen.

NotSupportedException

Das Abrufen von Autorisierungsgruppen wird von diesem Betriebssystem nicht unterstützt.

Hinweise

Diese Methode durchsucht alle Gruppen rekursiv und gibt die Gruppen zurück, in denen der Benutzer Mitglied ist. Der zurückgegebene Satz kann auch zusätzliche Gruppen enthalten, die den Benutzer zu Autorisierungszwecken als Mitglied betrachten würden.

Die Gruppen, die von dieser Methode zurückgegeben werden, können Gruppen aus einem anderen Bereich und Speicher als der Prinzipal enthalten. Wenn der Prinzipal beispielsweise ein AD DS-Objekt mit dem DN "CN=SpecialGroups,DC=Fabrikam,DC=com" ist, kann der zurückgegebene Satz Gruppen enthalten, die zu "CN=NormalGroups,DC=Fabrikam,DC=com" gehören.