未分类--Windows API--CIDLData_CreateFromIDArray

原文来自MSDN Library for Visual Studio 2008 SP1，翻译部分仅为个人观点，想要看更多信息请看MSDN，如有版权问题请联系QQ 643166601，邮件[e-mail]

 

CIDLData_CreateFromIDArray Function

--------------------------------------------------------------------------------

Creates a data object with the default Vtable pointer.
创建一个数据对象用默认的虚表指针
Syntax

HRESULT CIDLData_CreateFromIDArray(         
PCIDLIST_ABSOLUTE pidlFolder,
UINT cidl,
PCUIDLIST_RELATIVE apidl,
IDataObject **ppdtobj
);
Parameters

pidlFolder
[in] A fully qualified IDLIST for the root of the items specified in apidl.
一个完全限定的IDLIST对于在apidl中指定元素的根。
cidl
[in] The number of entries in the apidl array.
在apidl数组中入口的数量。
apidl
[in] The array of item IDs relative to pidlFolder.
这个数组的项IDs相对pidlFolder。
Typically, apidl is an array of child IDs and pidlFolder is a full pointer to an item identifier list (PIDL) for those items.
通常，apidl是一个数组的子IDs并且pidlFolder是完整指针指向一个这些项的项目标识符列表(PIDL)。
However, pidlFolder can be a null PIDL (desktop IDLISTs).
然而，pidlFolder可以是空PIDL(桌面IDLISTs)。
In that case, apidl can contain fully qualified ID lists.
在这种情况，apidl可以包含完全限定的ID列表。
ppdtobj
[out] The address to a pointer to the object that implements IDataObject.
这个地址指向指针到实现IDataObject的对象。
Return Value

Returns S_OK if successful, or an error value otherwise.
如果成功返回S_OK，或否则错误代码。
Remarks

The data object created by this function offers the Shell clipboard format identifier CFSTR_SHELLIDLIST.
这个函数提供创建的数据对象的Shell剪切板格式的标识符CFSTR_SHELLIDLIST。
This data object also supports IDataObject::SetData calls to pick up other clipboard formats.
这个数据对象也支持IDataObject::SetData调用拾器其他剪切板格式。
Note  The CIDLData_CreateFromIDArray function will be available for use in the Windows Vista operating system.
注意 这个CIDLData_CreateFromIDArray函数将在Windows Vista操作系统中可用。
It might be altered or unavailable in subsequent versions.
它可能被修改或不可用在随后的版本中。
Function Information

Minimum DLL Version shell32.dll version 5.0 or later
Custom Implementation No
Header shlobj.h
Import library shell32.lib
Minimum operating systems Windows 2000

See Also

SHCreateDataObject