Поделиться через


Метод IAzClientContext::GetRoles (azroles.h)

Метод GetRoles возвращает роли для контекста клиента.

Синтаксис

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

Параметры

[in, optional] bstrScopeName

Имя объекта IAzScope , из которого применимы роли, возвращаемые в параметре pvarRoleNames . Если это свойство имеет значение NULL, возвращаются роли из область приложения; в противном случае роли из указанного область возвращаются вместо ролей из область приложения.

[out] pvarRoleNames

Указатель на VARIANT , используемый для возврата SAFEARRAY. Каждый элемент SAFEARRAY является variant типа BSTR, который содержит имя роли, которой принадлежит клиент, в область, заданном параметром bstrScopeName.

Возвращаемое значение

Возвращаемое значение — HRESULT. Значение S_OK указывает на успешное выполнение. Любое другое значение указывает, что операция завершилась сбоем.

Комментарии

В JScript возвращенный объект SAFEARRAY необходимо преобразовать в объект Массив JScript.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header azroles.h
Библиотека Azroles.lib
DLL Azroles.dll
Распространяемые компоненты Пакет средств администрирования Windows Server 2003 в Windows XP