IAzObjectPicker::GetPrincipals メソッド (azroles.h)

GetPrincipals メソッドは、ユーザーが 1 つ以上のプリンシパルを選択できるダイアログ ボックスを表示し、選択したプリンシパルの一覧とそれに対応するセキュリティ識別子 (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 オブジェクトを含むバリアントです。 配列の各要素は、 SID_NAME_USE 列挙体の要素を指定する VT_I4 値を保持します。

[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