Méthode IAzClientContext ::GetRoles (azroles.h)

La méthode GetRoles retourne les rôles pour le contexte client.

Syntaxe

HRESULT GetRoles(
  [in, optional] BSTR    bstrScopeName,
  [out]          VARIANT *pvarRoleNames
);

Paramètres

[in, optional] bstrScopeName

Nom de l’objet IAzScope à partir duquel les rôles retournés dans le paramètre pvarRoleNames sont applicables. Si cette propriété a la valeur NULL, les rôles de l’étendue de l’application sont retournés ; sinon, les rôles de l’étendue spécifiée sont retournés à la place des rôles de l’étendue de l’application.

[out] pvarRoleNames

Pointeur vers un VARIANT utilisé pour retourner un SAFEARRAY. Chaque élément du SAFEARRAY est un VARIANT de type BSTR qui contient le nom d’un rôle auquel le client appartient à l’étendue spécifiée par le paramètre bstrScopeName .

Valeur retournée

La valeur de retour est un HRESULT. La valeur S_OK indique la réussite. Toute autre valeur indique que l’opération a échoué.

Remarques

Dans JScript, le SAFEARRAY retourné doit être converti en objet JScript Array .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	azroles.h
Bibliothèque	Azroles.lib
DLL	Azroles.dll
Composant redistribuable	Windows Server 2003 Administration Tools Pack sur Windows XP