Principal.GetGroups Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Retourne une collection d’objets de groupe qui spécifient les groupes dont le principal actuel est membre.
Surcharges
| Nom | Description |
|---|---|
| GetGroups() |
Retourne une collection d’objets de groupe qui spécifient les groupes dont le principal actuel est membre. |
| GetGroups(PrincipalContext) |
Retourne une collection d’objets de groupe dont le principal est membre et qui existe dans le magasin fourni par le paramètre de contexte spécifié. |
Remarques
Cette méthode surchargée retourne uniquement les groupes dont le principal est directement membre ; aucune recherche récursive n’est effectuée. Les résultats de la recherche récursive sont disponibles pour les objets principaux de l’utilisateur. Pour plus d’informations, consultez la GetAuthorizationGroups méthode.
Si le magasin principal est AD DS, la liste des groupes contient le groupe principal de l’utilisateur identifié par l’attribut ID de groupe principal dans l’objet AD DS.
GetGroups()
Retourne une collection d’objets de groupe qui spécifient les groupes dont le principal actuel est membre.
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)Retours
Collection d’objets GroupPrincipal qui spécifient les groupes dont le principal actuel est membre.
- Attributs
Remarques
Cette méthode retourne uniquement les groupes dont le principal est directement membre ; aucune recherche récursive n’est effectuée. Les résultats de la recherche récursive sont disponibles pour les objets principaux de l’utilisateur. Pour plus d’informations, consultez la GetAuthorizationGroups méthode.
Les groupes retournés par cette méthode peuvent inclure des groupes d’une étendue et d’un magasin différents de celui du principal. Par exemple, si le principal est un objet AD DS qui a un nom de domaine « CN=SpecialGroups,DC=Fabrikam,DC=com, le jeu retourné peut contenir des groupes qui appartiennent au « CN=NormalGroups,DC=Fabrikam,DC=com.
Si le principal actuel est un principal AD DS, les groupes retournés incluent le groupe principal des principaux, comme indiqué par l’attribut « primaryGroupId » sur l’objet AD DS.
Voir aussi
S’applique à
GetGroups(PrincipalContext)
Retourne une collection d’objets de groupe dont le principal est membre et qui existe dans le magasin fourni par le paramètre de contexte spécifié.
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)Paramètres
- contextToQuery
- PrincipalContext
Objet PrincipalContext qui spécifie le contexte sur lequel la requête est effectuée.
Lorsque le contexte se trouve dans un autre domaine, la requête est effectuée sur la représentation des objets principaux dans le contexte spécifié.
Retours
Collection d’objets GroupPrincipal qui spécifient les groupes dont le principal actuel est membre.
- Attributs
Remarques
Cette méthode retourne uniquement les groupes dont le principal est directement membre ; aucune recherche récursive n’est effectuée. Les résultats de la recherche récursive sont disponibles pour les objets principaux de l’utilisateur. Pour plus d’informations, consultez la GetAuthorizationGroups méthode.
Les groupes retournés par cette méthode peuvent inclure des groupes d’une étendue et d’un magasin différents de celui du principal. Par exemple, si le principal est un objet AD DS qui a un nom de domaine « CN=SpecialGroups,DC=Fabrikam,DC=com, le jeu retourné peut contenir des groupes qui appartiennent au « CN=NormalGroups,DC=Fabrikam,DC=com.
Si le principal actuel est un principal AD DS, les groupes retournés incluent le groupe principal des principaux, comme indiqué par l’attribut ID de groupe principal sur l’objet AD DS.