IAzClientContext：：GetRoles 方法 (azroles.h)

  • 项目

GetRoles 方法返回客户端上下文的角色。

语法

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

参数

[in, optional] bstrScopeName

PvarRoleNames 参数中返回的角色适用的 IAzScope 对象的名称。 如果此属性为 NULL，则返回应用程序范围中的角色;否则，将返回指定范围中的角色，而不是应用程序范围中的角色。

[out] pvarRoleNames

指向用于返回 SAFEARRAY 的 VARIANT 的指针。 SAFEARRAY 的每个元素都是类型为 BSTR 的 VARIANT，其中包含客户端在 bstrScopeName 参数指定的范围内所属的角色的名称。

返回值

返回值为 HRESULT。 值为 S_OK 表示成功。 任何其他值指示操作失败。

注解

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

要求

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