Principal.GetGroups Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt eine Auflistung von Gruppenobjekten zurück, die die Gruppen angeben, von denen der aktuelle Prinzipal mitglied ist.
Überlädt
| Name | Beschreibung |
|---|---|
| GetGroups() |
Gibt eine Auflistung von Gruppenobjekten zurück, die die Gruppen angeben, von denen der aktuelle Prinzipal mitglied ist. |
| GetGroups(PrincipalContext) |
Gibt eine Auflistung von Gruppenobjekten zurück, bei denen der Prinzipal mitglied ist und die im Speicher vorhanden sind, der vom angegebenen Kontextparameter bereitgestellt wird. |
Hinweise
Diese überladene Methode gibt nur die Gruppen zurück, von denen der Prinzipal direkt mitglied ist; es werden keine rekursiven Suchvorgänge ausgeführt. Rekursive Suchergebnisse sind für Benutzerprinzipalobjekte verfügbar. Weitere Informationen finden Sie in der GetAuthorizationGroups Methode.
Wenn der Prinzipalspeicher AD DS ist, enthält die Liste der Gruppen die primäre Gruppe des Benutzers, die durch das primäre Gruppen-ID-Attribut im AD DS-Objekt identifiziert wird.
GetGroups()
- Quelle:
- Principal.cs
- Quelle:
- Principal.cs
- Quelle:
- Principal.cs
- Quelle:
- Principal.cs
Gibt eine Auflistung von Gruppenobjekten zurück, die die Gruppen angeben, von denen der aktuelle Prinzipal mitglied ist.
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)Gibt zurück
Eine Auflistung von GroupPrincipal Objekten, die die Gruppen angeben, von denen der aktuelle Prinzipal mitglied ist.
- Attribute
Hinweise
Diese Methode gibt nur die Gruppen zurück, von denen der Prinzipal direkt Mitglied ist; es werden keine rekursiven Suchvorgänge ausgeführt. Rekursive Suchergebnisse sind für Benutzerprinzipalobjekte verfügbar. Weitere Informationen finden Sie in der GetAuthorizationGroups Methode.
Die von dieser Methode zurückgegebenen Gruppen können Gruppen aus einem anderen Bereich und Speicher als dem Prinzipal enthalten. Wenn der Prinzipal beispielsweise ein AD DS-Objekt ist, das einen DN von "CN=SpecialGroups,DC=Fabrikam,DC=com" aufweist, kann der zurückgegebene Satz Gruppen enthalten, die zum "CN=NormalGroups,DC=Fabrikam,DC=com" gehören.
Wenn der aktuelle Prinzipal ein AD DS-Prinzipal ist, enthalten die zurückgegebenen Gruppen die primäre Hauptgruppe, wie durch das Attribut "primaryGroupId" für das AD DS-Objekt angegeben.
Weitere Informationen
Gilt für:
GetGroups(PrincipalContext)
- Quelle:
- Principal.cs
- Quelle:
- Principal.cs
- Quelle:
- Principal.cs
- Quelle:
- Principal.cs
Gibt eine Auflistung von Gruppenobjekten zurück, bei denen der Prinzipal mitglied ist und die im Speicher vorhanden sind, der vom angegebenen Kontextparameter bereitgestellt wird.
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)Parameter
- contextToQuery
- PrincipalContext
Das PrincipalContext Objekt, das den Kontext angibt, für den die Abfrage ausgeführt wird.
Wenn sich der Kontext in einer anderen Domäne befindet, wird die Abfrage für die Darstellung der Prinzipalobjekte im angegebenen Kontext ausgeführt.
Gibt zurück
Eine Auflistung von GroupPrincipal Objekten, die die Gruppen angeben, von denen der aktuelle Prinzipal mitglied ist.
- Attribute
Hinweise
Diese Methode gibt nur die Gruppen zurück, von denen der Prinzipal direkt Mitglied ist; es werden keine rekursiven Suchvorgänge ausgeführt. Rekursive Suchergebnisse sind für Benutzerprinzipalobjekte verfügbar. Weitere Informationen finden Sie in der GetAuthorizationGroups Methode.
Die von dieser Methode zurückgegebenen Gruppen können Gruppen aus einem anderen Bereich und Speicher als dem Prinzipal enthalten. Wenn der Prinzipal beispielsweise ein AD DS-Objekt ist, das einen DN von "CN=SpecialGroups,DC=Fabrikam,DC=com" aufweist, kann der zurückgegebene Satz Gruppen enthalten, die zum "CN=NormalGroups,DC=Fabrikam,DC=com" gehören.
Wenn der aktuelle Prinzipal ein AD DS-Prinzipal ist, enthalten die zurückgegebenen Gruppen die primäre Hauptgruppe, wie durch das primäre Gruppen-ID-Attribut für das AD DS-Objekt angegeben.
