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 |