Метод 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