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 で指定された子項目の親であるシェル データ ソース オブジェクト。 pidlParent が指定されている場合、このパラメーターは NULL にすることができます。

[in] cidl

型: UINT

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

[in] ppidl

型: PCUITEMID_CHILD_ARRAY

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

[out] ppsiItemArray

型: IShellItemArray**

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

戻り値

型: HRESULT

この関数が成功すると、S_OKが返 されます。 それ以外の場合は、 HRESULT エラー コードが返されます。

Requirements