SHCreateShellItemArray 関数 (shobjidl_core.h)

シェル項目配列オブジェクトを作成します。

構文

SHSTDAPI SHCreateShellItemArray(
  [in]  PCIDLIST_ABSOLUTE     pidlParent,
  [in]  IShellFolder          *psf,
  [in]  UINT                  cidl,
  [in]  PCUITEMID_CHILD_ARRAY ppidl,
  [out] IShellItemArray       **ppsiItemArray
);

パラメーター

[in] pidlParent

種類: PCIDLIST_ABSOLUTE

ppidl で指定された項目の親フォルダーの ID リスト。 psf を指定した場合、このパラメーターは NULL にすることができます。 この pidlParent が指定されていない場合は、iPersistFolder2 を使用して psf パラメーターから計算されます。

[in] psf

種類: IShellFolder*

ppidl で指定された子項目の親である Shell データ ソース オブジェクト。 pidlParent を指定した場合、このパラメーターは NULL にすることができます。

[in] cidl

型: UINT

ppidl で指定された配列内の要素の数。

[in] ppidl

種類: PCUITEMID_CHILD_ARRAY

配列が作成される子項目 ID の一覧。 この値には NULL を指定できます。

[out] ppsiItemArray

種類: IShellItemArray**

この関数から制御が戻るときに、 IShellItemArray インターフェイス ポインターのアドレスが格納されます。

戻り値

型: HRESULT

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)
[DLL]	Shell32.dll