Partager via


Méthode IAzClientContext3 ::GetGroups (azroles.h)

La méthode GetGroups retourne un tableau des groupes d’applications associés à ce contexte client.

Syntaxe

HRESULT GetGroups(
  [in]  BSTR    bstrScopeName,
  [in]  ULONG   ulOptions,
  [out] VARIANT *pGroupArray
);

Paramètres

[in] bstrScopeName

Nom de l’étendue dans laquelle case activée pour les groupes d’applications. Ce paramètre est ignoré si la valeur du paramètre ulOptions est définie sur AZ_CLIENT_CONTEXT_GET_GROUPS_STORE_LEVEL_ONLY.

[in] ulOptions

Ensemble d’indicateurs qui modifient le comportement de cette méthode. Il peut s’agir de zéro ou d’une combinaison d’une ou plusieurs des valeurs suivantes.

Valeur Signification
AZ_CLIENT_CONTEXT_GET_GROUPS_STORE_LEVEL_ONLY
0x2
Cette méthode vérifie uniquement les groupes d’applications au niveau du magasin.

[out] pGroupArray

Pointeur vers un tableau des noms des groupes d’applications associés à ce contexte client.

Il s’agit d’une variante qui contient un objet SAFEARRAY ou JScript Array . Chaque élément du tableau contient une VT_BSTR qui contient le nom d’un groupe d’applications.

Valeur retournée

Si la méthode réussit, elle retourne S_OK.

En cas d'échec de la méthode, retourne un code d'erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête azroles.h

Voir aussi

IAzClientContext3