OleDuplicateData 函数 (ole2.h)

复制在指定句柄中找到的数据,并返回重复数据的句柄。 源数据采用剪贴板格式。 使用此函数来帮助实现某些数据传输接口,例如 IDataObject

语法

HANDLE OleDuplicateData(
  [in] HANDLE     hSrc,
  [in] CLIPFORMAT cfFormat,
  [in] UINT       uiFlags
);

参数

[in] hSrc

源数据的句柄。

[in] cfFormat

源数据的剪贴板格式。

[in] uiFlags

用于为复制的数据分配全局内存的标志。 这些标志将传递到 GlobalAlloc。 如果 uiFlags 的值为 NULL,则GMEM_MOVEABLE用作默认标志。

返回值

成功后,返回源数据的 HANDLE;如果失败,则返回 NULL 值。

注解

CF_METAFILEPICT、CF_PALETTE或CF_BITMAP格式接收特殊处理。 它们是 GDI 句柄,必须创建新的 GDI 对象,而不仅仅是复制字节。 所有其他格式均按字节重复。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 ole2.h
Library Ole32.lib
DLL Ole32.dll