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 ()

另请参阅

SHCreateDataObject