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 類型的 SID_NAME_USE 列舉元素陣列指標。

這是包含 SAFEARRAY 或 JScript Array 物件的變體。 陣列的每個元素都會保存 VT_I4 值，指定 SID_NAME_USE 列舉的專案。

[out] pvNames

用戶所選主體之顯示名稱陣列的指標。

這是包含 SAFEARRAY 或 JScript Array 物件的變體。 陣列的每個元素都會保存包含顯示名稱 的VT_BSTR 。

[out] pvSids

對應至使用者所選主體之 SID 之字串表示之字串表示的指標。

這是包含 SAFEARRAY 或 JScript Array 物件的變體。 數位的每個元素都會保存包含 SID 字串表示的 VT_BSTR 。

傳回值

如果方法成功，則會傳回 S_OK。

如果方法失敗，則會傳回錯誤碼。 如需常見錯誤碼的清單，請參閱 一般 HRESULT 值。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	azroles.h