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

El método GetAssignedScopesPage recupera una lista de los ámbitos en los que el cliente representado por el objeto IAzClientContext2 actual se asigna al menos a un rol.

Sintaxis

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

Parámetros

[in] lOptions

Marca que especifica si este método comprueba los grupos de consultas LDAP para la asignación de ámbito. Los grupos de consultas LDAP previamente almacenados en caché se comprueban independientemente del valor de esta marca.

Valor	Significado
AZ_CLIENT_CONTEXT_SKIP_LDAP_QUERY 1	No se comprueban los grupos de consultas LDAP que no se almacenaron en caché previamente.

[in] PageSize

Número de elementos de cada resultado de página.

[in, out] pvarCursor

Puntero a un variant que representa la página actual de resultados. Para la primera llamada al método GetAssignedScopesPage , pase VT_EMPTY como valor de este parámetro para recuperar la primera página de resultados. El número de elementos de una página viene determinado por el valor del parámetro PageSize . En la salida, este parámetro contiene el valor que se pasará en la siguiente llamada a GetAssignedScopesPage para recuperar la página siguiente de resultados. Si el valor de este parámetro en la salida es EMPTY, no hay más páginas de resultados.

pvarScopeNames

En la devolución, contiene una matriz de variables de tipo VARIANT. Cada elemento de la matriz es de tipo VT_BSTR y contiene el nombre de un ámbito al que se asigna el cliente actual. El parámetro PageSize especifica el número de elementos de la matriz.

Valor devuelto

Si el método se realiza correctamente, el método devuelve S_OK.

Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Comentarios

Si varios subprocesos acceden al mismo almacén de autorización, es posible que una llamada al método GetAssignedScopesPage en uno de los subprocesos no devuelva resultados precisos si el otro subproceso modifica el almacén.

En JScript, los valores SAFEARRAY devueltos deben convertirse en el objeto Array de JScript.

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2008, Windows Server 2003 con SP1 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	azroles.h
Library	Azroles.lib
Archivo DLL	Azroles.dll
Redistribuible	Paquete de herramientas de administración de Windows Server 2003 en Windows XP