共用方式為

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 Array 物件。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 azroles.h
程式庫 Azroles.lib
Dll Azroles.dll
可轉散發套件 Windows XP 上的 Windows Server 2003 系統管理工具套件