Share via

Метод 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 с пакетом обновления 1 (SP1) [только классические приложения]
Целевая платформа Windows
Header azroles.h
Библиотека Azroles.lib
DLL Azroles.dll
Распространяемые компоненты Пакет средств администрирования Windows Server 2003 в Windows XP