网站首页  词典首页

请输入您要查询的函数:

 

术语 shcreateshellitemarrayfromdataobject
释义 SHCreateShellItemArrayFromDataObject
语法:
HRESULT SHCreateShellItemArrayFromDataObject( IDataObject *pdo,
REFIID riid,
void **ppv
);
SHCreateShellItemArrayFromDataObject功能
创建壳牌项目从一个数据数组对象的对象。
参数
专业发展主任
[in]一个IDataObject接口指针。
riid
编号[in]对所需的接口的引用。
PPV的
[内]当此方法返回,包含了接口指针riid请求。这通常是IShellItemArray。
返回值
返回S_OK如果成功,或其他错误值。
备注
此函数是有用的扩展壳牌执行IShellExtInit和传递数据对象的IShellExtInit::Initialize方法,例如,上下文菜单处理程序。
这个API可以让您的数据对象转换成壳牌项目的处理程序会消耗。这是建议处理程序使用壳牌项目的数组,而不是像CF_HDROP剪贴板和CFSTR_SHELLIDLIST格式(也称为飞),因为它导致简单的代码,并允许一些性能改进。
由此产生的一系列壳项目持有源数据对象的引用。因此,该数据对象必须是有效的shell项目阵列的寿命。值得注意的是,数据对象传递给IDropTarget接口的方法后,不再有效的拖放操作完成。
功能信息
最低DLL版本 Shell32.dll
自定义ImplementationNo
Headershobjidl.h
import libraryNone
最低支持操作系统 Vista
==英文原文==SHCreateShellItemArrayFromDataObject Function
Creates a Shell item array object from a data object.
Syntax
HRESULT SHCreateShellItemArrayFromDataObject( IDataObject *pdo,
REFIID riid,
void **ppv
);
Parameters
pdo
[in] A pointer to IDataObject interface.
riid
[in] A reference to the desired interface ID.
ppv
[out] When this method returns, contains the interface pointer requested in riid. This is typically IShellItemArray .
Return Value
Returns S_OK if successful, or an error value otherwise.
Remarks
This function is usefull for Shell extensions that implement IShellExtInit and are passed a data object to the IShellExtInit::Initialize method; for example, context menu handlers.
This API lets you convert the data object into a Shell item that the handler can consume. It is recommend that handlers use a Shell item array rather than clipboard formats like CF_HDROP and CFSTR_SHELLIDLIST (also known as HIDA) as it leads to simpler code and allows some performance improvements.
The resulting shell item array holds a reference to the source data object. Therefore, that data object must remain valid for the lifetime of the shell item array. Notably, the data objects passed to IDropTarget methods are no longer valid after the drop operation completes.
Function Information
Minimum DLL VersionShell32.dll
Custom ImplementationNo
Headershobjidl.h
Import libraryNone
Minimum operating systemsWindows Vista
==原始网址==http://msdn.microsoft.com/en-us/library/bb762145(VS.85).aspx\n
随便看

 

windows api函数参考手册包含2258条windows api函数文档,详细介绍nodejs、java、rust调用windows api的方法技巧,是学习windows api编程的入门中文文档。

 

Copyright © 2004-2023 Winrtm.com All Rights Reserved
京ICP备2021023879号-40 更新时间:2024/10/6 11:29:40