CIDLData_CreateFromIDArray函式 (shlobj_core.h)
[CIDLData_CreateFromIDArray 可用於需求一節中指定的操作系統。 後續版本可能會變更或無法使用。]
使用預設 vtable 指標建立資料物件。
語法
SHSTDAPI CIDLData_CreateFromIDArray(
[in] PCIDLIST_ABSOLUTE pidlFolder,
[in] UINT cidl,
[in] PCUIDLIST_RELATIVE_ARRAY apidl,
[out] IDataObject **ppdtobj
);
參數
[in] pidlFolder
類型: PCIDLIST_ABSOLUTE
apidl 中所指定專案根目錄的完整 IDLIST。
[in] cidl
類型: UINT
apidl 陣列中的項目數。
[in] apidl
類型: PCUIDLIST_RELATIVE_ARRAY
相對於 pidlFolder 的項目標識子陣列。 一般而言, apidl 是子標識符的陣列, 而 pidlFolder 是這些專案的完整 PIDL。 不過, pidlFolder 可以是 null PIDL (桌面 IDLIST) 。 在此情況下, apidl 可以包含完整標識符清單。
[out] ppdtobj
類型: IDataObject**
實作 IDataObject 之物件的指標位址。
傳回值
類型: HRESULT
如果此函式成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
此函式所建立的數據物件會提供殼層剪貼簿格式標識碼 CFSTR_SHELLIDLIST。 此數據物件也支援 IDataObject::SetData 呼叫,以挑選其他剪貼簿格式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | shlobj_core.h (包含 Shlobj.h) |
程式庫 | Shell32.lib |
Dll | Shell32.dll (5.0 版或更新版本) |
API 集合 | ext-ms-win-shell-shell32-l1-2-1 (於 Windows 10 10.0.10240 版) |