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 的项 ID 数组。 通常， apidl 是子 ID 的数组， pidlFolder 是这些项的完整 PIDL。 但是， pidlFolder 可以是 (桌面 IDLIST) 的 NULL PIDL。 在这种情况下， apidl 可以包含完全限定的 ID 列表。
[out] ppdtobj
类型： IDataObject**
指向实现 IDataObject 的对象的指针的地址。
返回值
类型： HRESULT
如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。
注解
此函数创建的数据对象提供 Shell 剪贴板格式标识符 CFSTR_SHELLIDLIST。 此数据对象还支持 IDataObject：：SetData 调用来选取其他剪贴板格式。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | shlobj_core.h (包括 Shlobj.h) |
| Library | Shell32.lib |
| DLL | Shell32.dll (5.0 或更高版本) |
| API 集 | Windows 10版本 10.0.10240 中引入的 ext-ms-win-shell-shell32-l1-2-1 () |