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

Article
02/26/2024

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

Partager via