Principal.GetGroups Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Returnerar en samling gruppobjekt som anger vilka grupper som det aktuella huvudkontot är medlem i.
Överlagringar
| Name | Description |
|---|---|
| GetGroups() |
Returnerar en samling gruppobjekt som anger vilka grupper som det aktuella huvudkontot är medlem i. |
| GetGroups(PrincipalContext) |
Returnerar en samling gruppobjekt som huvudnamnet är medlem i och som finns i arkivet som tillhandahålls av den angivna kontextparametern. |
Kommentarer
Den här överlagrade metoden returnerar endast de grupper som huvudkontot är direkt medlem i. inga rekursiva sökningar utförs. Rekursiva sökresultat är tillgängliga för objekt med användarens huvudnamn. Mer information finns i GetAuthorizationGroups-metoden.
Om huvudarkivet är AD DS innehåller listan över grupper användarens primära grupp som identifieras av det primära grupp-ID-attributet i AD DS-objektet.
GetGroups()
Returnerar en samling gruppobjekt som anger vilka grupper som det aktuella huvudkontot är medlem i.
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)
Returer
En samling GroupPrincipal objekt som anger vilka grupper som det aktuella huvudkontot är medlem i.
- Attribut
Kommentarer
Den här metoden returnerar endast de grupper som huvudkontot är direkt medlem i. inga rekursiva sökningar utförs. Rekursiva sökresultat är tillgängliga för objekt med användarens huvudnamn. Mer information finns i GetAuthorizationGroups-metoden.
De grupper som returneras av den här metoden kan innehålla grupper från ett annat omfång och arkiv än huvudnamnet. Om huvudnamnet till exempel är ett AD DS-objekt som har ett DN med "CN=SpecialGroups,DC=Fabrikam,DC=com, kan den returnerade uppsättningen innehålla grupper som tillhör "CN=NormalGroups,DC=Fabrikam,DC=com.
Om det aktuella huvudkontot är ett AD DS-huvudnamn inkluderar de returnerade grupperna huvudnamnens primära grupp, vilket anges av attributet "primaryGroupId" för AD DS-objektet.
Se även
Gäller för
GetGroups(PrincipalContext)
Returnerar en samling gruppobjekt som huvudnamnet är medlem i och som finns i arkivet som tillhandahålls av den angivna kontextparametern.
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)
Parametrar
- contextToQuery
- PrincipalContext
Objektet PrincipalContext som anger kontexten som frågan ska utföras mot.
När kontexten finns i en annan domän utförs frågan mot huvudobjektets representation i den angivna kontexten.
Returer
En samling GroupPrincipal objekt som anger vilka grupper som det aktuella huvudkontot är medlem i.
- Attribut
Kommentarer
Den här metoden returnerar endast de grupper som huvudkontot är direkt medlem i. inga rekursiva sökningar utförs. Rekursiva sökresultat är tillgängliga för objekt med användarens huvudnamn. Mer information finns i GetAuthorizationGroups-metoden.
De grupper som returneras av den här metoden kan innehålla grupper från ett annat omfång och arkiv än huvudnamnet. Om huvudnamnet till exempel är ett AD DS-objekt som har ett DN med "CN=SpecialGroups,DC=Fabrikam,DC=com, kan den returnerade uppsättningen innehålla grupper som tillhör "CN=NormalGroups,DC=Fabrikam,DC=com.
Om det aktuella huvudkontot är ett AD DS-huvudnamn inkluderar de returnerade grupperna den primära huvudgrupp som anges av det primära grupp-ID-attributet för AD DS-objektet.