Méthode IAzClientContext2 ::GetAssignedScopesPage (azroles.h)

La méthode GetAssignedScopesPage récupère une liste des étendues dans lesquelles le client représenté par l’objet IAzClientContext2 actuel est affecté à au moins un rôle.

Syntaxe

HRESULT GetAssignedScopesPage(
  [in]      LONG    lOptions,
  [in]      LONG    PageSize,
  [in, out] VARIANT *pvarCursor,
            VARIANT *pvarScopeNames
);

Paramètres

[in] lOptions

Indicateur qui spécifie si cette méthode vérifie l’attribution d’étendue aux groupes de requêtes LDAP. Les groupes de requêtes LDAP précédemment mis en cache sont vérifiés quelle que soit la valeur de cet indicateur.

Valeur	Signification
AZ_CLIENT_CONTEXT_SKIP_LDAP_QUERY 1	Les groupes de requêtes LDAP qui n’ont pas été précédemment mis en cache ne sont pas vérifiés.

[in] PageSize

Nombre d’éléments dans chaque résultat de page.

[in, out] pvarCursor

Pointeur vers un VARIANT qui représente la page de résultats actuelle. Pour le premier appel à la méthode GetAssignedScopesPage , transmettez VT_EMPTY comme valeur pour ce paramètre afin de récupérer la première page de résultats. Le nombre d’éléments sur une page est déterminé par la valeur du paramètre PageSize . Lors de la sortie, ce paramètre contient la valeur à passer dans l’appel suivant à GetAssignedScopesPage pour récupérer la page de résultats suivante. Si la valeur de ce paramètre sur la sortie est EMPTY, il n’y a plus de pages de résultats.

pvarScopeNames

Au retour, contient un tableau de variables de type VARIANT. Chaque élément du tableau est de type VT_BSTR et contient le nom d’une étendue à laquelle le client actuel est affecté. Le nombre d’éléments dans le tableau est spécifié par le paramètre PageSize .

Valeur retournée

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

Si la méthode échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Remarques

Si plusieurs threads accèdent au même magasin d’autorisations, un appel à la méthode GetAssignedScopesPage sur l’un des threads peut ne pas retourner des résultats précis si l’autre thread modifie le magasin.

Dans JScript, les valeurs SAFEARRAY retournées doivent être converties en objet JScript Array .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008, Windows Server 2003 avec SP1 [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