Функция 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
Header	ole2.h
Библиотека	Ole32.lib
DLL	Ole32.dll