Principal.GetGroups Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een verzameling groepsobjecten geretourneerd waarmee de groepen worden opgegeven waarvan de huidige principal lid is.
Overloads
| Name | Description |
|---|---|
| GetGroups() |
Hiermee wordt een verzameling groepsobjecten geretourneerd waarmee de groepen worden opgegeven waarvan de huidige principal lid is. |
| GetGroups(PrincipalContext) |
Retourneert een verzameling groepsobjecten waarvan de principal lid is en die aanwezig zijn in het archief dat wordt geleverd door de opgegeven contextparameter. |
Opmerkingen
Deze overbelaste methode retourneert alleen de groepen waarvan de principal rechtstreeks lid is; er worden geen recursieve zoekopdrachten uitgevoerd. Recursieve zoekresultaten zijn beschikbaar voor user principal-objecten. Zie de GetAuthorizationGroups methode voor meer informatie.
Als het principal-archief AD DS is, bevat de lijst met groepen de primaire groep van de gebruiker die wordt geïdentificeerd door het kenmerk primaire groeps-id in het AD DS-object.
GetGroups()
Hiermee wordt een verzameling groepsobjecten geretourneerd waarmee de groepen worden opgegeven waarvan de huidige principal lid is.
public:
System::DirectoryServices::AccountManagement::PrincipalSearchResult<System::DirectoryServices::AccountManagement::Principal ^> ^ GetGroups();[System.Security.SecurityCritical]
public System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal> GetGroups();[<System.Security.SecurityCritical>]
member this.GetGroups : unit -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal>Public Function GetGroups () As PrincipalSearchResult(Of Principal)Retouren
Een verzameling GroupPrincipal objecten die de groepen opgeven waarvan de huidige principal lid is.
- Kenmerken
Opmerkingen
Deze methode retourneert alleen de groepen waarvan de principal rechtstreeks lid is; er worden geen recursieve zoekopdrachten uitgevoerd. Recursieve zoekresultaten zijn beschikbaar voor user principal-objecten. Zie de GetAuthorizationGroups methode voor meer informatie.
De groepen die door deze methode worden geretourneerd, kunnen groepen uit een ander bereik bevatten en opslaan dan de principal. Als de principal bijvoorbeeld een AD DS-object is met een DN van CN=SpecialGroups,DC=Fabrikam,DC=com, kan de geretourneerde set groepen bevatten die deel uitmaken van de "CN=NormalGroups,DC=Fabrikam,DC=com.
Als de huidige principal een AD DS-principal is, bevatten de geretourneerde groepen de primaire principals-groep, zoals aangegeven door het kenmerk primaryGroupId in het AD DS-object.
Zie ook
Van toepassing op
GetGroups(PrincipalContext)
Retourneert een verzameling groepsobjecten waarvan de principal lid is en die aanwezig zijn in het archief dat wordt geleverd door de opgegeven contextparameter.
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);[<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)Parameters
- contextToQuery
- PrincipalContext
Het PrincipalContext object dat de context aangeeft waarop de query wordt uitgevoerd.
Wanneer de context zich in een ander domein bevindt, wordt de query uitgevoerd op basis van de weergave van de principal-objecten in de opgegeven context.
Retouren
Een verzameling GroupPrincipal objecten die de groepen opgeven waarvan de huidige principal lid is.
- Kenmerken
Opmerkingen
Deze methode retourneert alleen de groepen waarvan de principal rechtstreeks lid is; er worden geen recursieve zoekopdrachten uitgevoerd. Recursieve zoekresultaten zijn beschikbaar voor user principal-objecten. Zie de GetAuthorizationGroups methode voor meer informatie.
De groepen die door deze methode worden geretourneerd, kunnen groepen uit een ander bereik bevatten en opslaan dan de principal. Als de principal bijvoorbeeld een AD DS-object is met een DN van CN=SpecialGroups,DC=Fabrikam,DC=com, kan de geretourneerde set groepen bevatten die deel uitmaken van de "CN=NormalGroups,DC=Fabrikam,DC=com.
Als de huidige principal een AD DS-principal is, bevatten de geretourneerde groepen de primaire groep principals, zoals aangegeven door het kenmerk primaire groeps-id op het AD DS-object.