建立 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 中指定項目的父資料夾的 ID 清單。 如果指定 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 錯誤碼。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| Header | shobjidl_core.h（包括 Shobjidl.h） |
| Library | OneCore.Lib |
| DLL | Shell32.dll |