IAzObjectPicker：：GetPrincipals 方法 (azroles.h)

GetPrincipals 方法显示一个对话框，用户可以从中选择一个或多个主体，然后返回所选的主体列表及其相应的安全标识符 (SID) 。

语法

HRESULT GetPrincipals(
  [in]  HWND    hParentWnd,
  [in]  BSTR    bstrTitle,
  [out] VARIANT *pvSidTypes,
  [out] VARIANT *pvNames,
  [out] VARIANT *pvSids
);

参数

[in] hParentWnd

对话框的父窗口的句柄。

[in] bstrTitle

对话框的显示标题。

[out] pvSidTypes

指向 SID_NAME_USE 枚举的元素数组的指针，这些元素指定与用户选择的主体对应的 SID 类型。

这是一个包含 SAFEARRAY 或 JScript 数组 对象的变体。 数组的每个元素都包含一个 VT_I4 值，该值指定 SID_NAME_USE 枚举的元素。

[out] pvNames

指向用户选择的主体的显示名称数组的指针。

这是一个包含 SAFEARRAY 或 JScript 数组 对象的变体。 数组的每个元素都包含一个包含显示名称 的VT_BSTR 。

[out] pvSids

指向 SID 的字符串表示形式的数组的指针，这些字符串表示形式对应于用户选择的主体。

这是一个包含 SAFEARRAY 或 JScript 数组 对象的变体。 数组的每个元素都包含一个 VT_BSTR ，其中包含 SID 的字符串表示形式。

返回值

如果该方法成功，则返回 S_OK。

如果方法失败，它将返回错误代码。 有关常见错误代码的列表，请参阅 常见 HRESULT 值。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	azroles.h