SHCreateShellItemArray 函式 (shobjidl_core.h)

建立Shell項目陣列物件。

語法

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 中所指定專案的父資料夾識別子清單。 如果指定 psf ，這個參數可以是 NULL。 如果未指定此 pidlParent，則會使用 IPersistFolder2 從 psf 參數計算。

[in] psf

類型： IShellFolder*

Shell 數據源物件，該物件是 ppidl 中所指定子專案的父代。 如果指定 pidlParent ，這個參數可以是 NULL。

[in] cidl

類型： UINT

由 ppidl 指定之陣列中的元素數目。

[in] ppidl

類型： PCUITEMID_CHILD_ARRAY

要為其建立陣列的子項目標識碼清單。 此值可以是 NULL。

[out] ppsiItemArray

類型： IShellItemArray**

當此函式傳回時，會包含 IShellItemArray 介面指標的位址。

傳回值

類型： HRESULT

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	shobjidl_core.h (包含 Shobjidl.h)
Dll	Shell32.dll