IAzClientContext2：：GetAssignedScopesPage 方法 (azroles.h)

  • 项目

GetAssignedScopesPage 方法检索由当前 IAzClientContext2 对象表示的客户端分配到至少一个角色的范围列表。

语法

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

参数

[in] lOptions

一个标志，指定此方法是否检查 LDAP 查询组的范围分配。 无论此标志的值如何，都会检查以前缓存的 LDAP 查询组。

值 含义
AZ_CLIENT_CONTEXT_SKIP_LDAP_QUERY
1
 不会检查以前未缓存的 LDAP 查询组。

[in] PageSize

每个页面结果中的元素数。

[in, out] pvarCursor

指向表示当前页结果的 VARIANT 的指针。 对于第一次调用 GetAssignedScopesPage 方法，传递 VT_EMPTY 作为此参数的值，以检索结果的第一页。 页面上的元素数由 PageSize 参数的值确定。 在输出时，此参数包含要在下一次调用 GetAssignedScopesPage 以检索下一页结果时传递的值。 如果输出中此参数的值为 EMPTY，则不再有结果页。

pvarScopeNames

返回时，包含 VARIANT 类型的变量数组。 数组的每个元素都属于 VT_BSTR 类型，并且包含当前客户端分配到的范围的名称。 数组中的元素数由 PageSize 参数指定。

返回值

如果该方法成功，该方法将返回S_OK。

如果方法失败，它将返回指示错误的 HRESULT 值。 有关常见错误代码的列表，请参阅 常见 HRESULT 值。

注解

如果多个线程访问同一授权存储区，则如果另一个线程修改存储区，对其中一个线程的 GetAssignedScopesPage 方法的调用可能不会返回准确的结果。

在 JScript 中，返回的 SAFEARRAY 值必须转换为 JScript 数组 对象。

要求

要求 值
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2008、Windows Server 2003 SP1 [仅限桌面应用]
目标平台 Windows
标头 azroles.h
Library Azroles.lib
DLL Azroles.dll
可再发行组件 Windows XP 上的 Windows Server 2003 管理工具包