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