| 术语 | shcreatedataobject |
| 释义 | SHCreateDataObject 语法： HRESULT SHCreateDataObject( PCIDLIST_ABSOLUTE pidlFolder, UINT cidl, PCUITEMID_CHILD_ARRAY apidl, IDataObject *pdtInner, REFIID riid, void **ppv ); SHCreateDataObject功能 创建一个数据在父文件夹对象。 参数 pidlFolder [in]一个指向ITEMIDLIST(的PIDL)的父文件夹包含的数据对象。 cidl [in]的文件对象或apidl参数中指定的子文件夹数。 apidl [in]一个指针数组常量ITEMIDLIST结构，每个唯一标识一个文件对象或子文件夹相对于父文件夹。每一个项目标识符列表必须包含精确的一个SHITEMID结构随后终止为零。 pdtInner [in]一个指向接口IDataObject的。此参数可以为NULL。只有指定pdtInner创建的对象的数据需要支持超出默认它是在创建指定格式的其他的FORMATETC剪贴板格式。此外，为填充对象创建的数据支持使用非通过调用方法IDataObject的默认剪贴板格式：：SetData并指定在参数pFormatetc通过FORMATETC结构格式。 riid [in]是对组件对象模型(COM)标识符的参考界面返回。这必须IID_IDataObject。 PPV的 [内]当此函数返回时，包含了接口指针riid请求。 返回值 返回S_OK如果成功，或其他错误值。 备注 这个函数通常称为在执行方法IShellFolder：：GetUIObjectOf。当一个接口ID IID_IDataObject接口指针的要求(使用参数riid)的执行者可以返回与SHCreateDataObject响应创建对象的接口指针。 此函数支持CFSTR_SHELLIDLIST(也称为飞)剪贴板格式，也有通过IDataObject的任意剪贴板格式通用的支持：：SetData。欲了解更多有关剪贴板格式的信息，看Shell剪贴板格式。 新的数据对象是拟用于诸如拖动操作拖放，其中数据是在给定的格式存储在剪贴板。 功能信息 最低DLL版本 Shell32.dll 自定义ImplementationNo Headershlobj.h import libraryNone 最低支持操作系统 Vista 参见 CIDLData_CreateFromIDArray ＝＝英文原文＝＝SHCreateDataObject Function Creates a data object in a parent folder. Syntax HRESULT SHCreateDataObject( PCIDLIST_ABSOLUTE pidlFolder, UINT cidl, PCUITEMID_CHILD_ARRAY apidl, IDataObject *pdtInner, REFIID riid, void **ppv ); Parameters pidlFolder [in] A pointer to an ITEMIDLIST (PIDL) of the parent folder that contains the data object. cidl [in] The number of file objects or subfolders specified in the apidl parameter. apidl [in] An array of pointers to constant ITEMIDLIST structures, each of which uniquely identifies a file object or subfolder relative to the parent folder. Each item identifier list must contain exactly one SHITEMID structure followed by a terminating zero. pdtInner [in] A pointer to interface IDataObject . This parameter can be NULL. Specify pdtInner only if the data object created needs to support additional FORMATETC clipboard formats beyond the default formats it is assigned at creation. Alternatively, provide support for populating the created data object using non-default clipboard formats by calling method IDataObject::SetData and specifying the format in the FORMATETC structure passed in parameter pFormatetc. riid [in] A reference to the identifier of the Component Object Model (COM) interface to return. This must be IID_IDataObject. ppv [out] When this function returns, contains the interface pointer requested in riid. Return Value Returns S_OK if successful, or an error value otherwise. Remarks This function is typically called when implementing method IShellFolder::GetUIObjectOf . When an interface pointer of interface ID IID_IDataObject is requested (using parameter riid), the implementer can return the interface pointer on the object created with SHCreateDataObject in response. This function supports the CFSTR_SHELLIDLIST (also know as HIDA) clipboard format and also has generic support for arbitrary clipboard formats through IDataObject::SetData. For more information on clipboard formats, see Shell Clipboard Formats. The new data object is intended to be used in operations such as drag-and-drop, in which the data is stored in the clipboard with a given format. Function Information Minimum DLL VersionShell32.dll Custom ImplementationNo Headershlobj.h Import libraryNone Minimum operating systemsWindows Vista See Also CIDLData_CreateFromIDArray ＝＝原始网址＝＝http://msdn.microsoft.com/en-us/library/bb762126(VS.85).aspx\n |
| 随便看 |
|
windows api函数参考手册包含2258条windows api函数文档，详细介绍nodejs、java、rust调用windows api的方法技巧，是学习windows api编程的入门中文文档。