Поделиться через

Функция OleQueryCreateFromData (ole2.h)

  • Статья

Проверяет, имеет ли объект данных один из форматов, позволяющих ему стать внедренным объектом, путем вызова функции OleCreateFromData или OleCreateStaticFromData .

Синтаксис

HRESULT OleQueryCreateFromData(
  [in] LPDATAOBJECT pSrcDataObject
);

Параметры

[in] pSrcDataObject

Указатель на интерфейс IDataObject в объекте передачи данных, который требуется запрашивать.

Возвращаемое значение

Эта функция возвращает S_OK при успешном выполнении. Ниже перечислены другие возможные значения.

Код возврата Описание
S_FALSE
 Отсутствуют форматы, поддерживающие создание встроенных или статических объектов.
OLE_S_STATIC
 Существуют форматы, поддерживающие создание статических объектов.

Комментарии

Когда приложение получает объект передачи данных с помощью вызова функции OleGetClipboard , приложение должно вызывать OleQueryCreateFromData в процессе принятия решения о включении или отключении команд Edit/Paste или Edit/Paste Special... . Он проверяет наличие следующих форматов в объекте данных:

  • CF_EMBEDDEDOBJECT
  • CF_EMBEDSOURCE
  • cfFileName
  • CF_METAFILEPICT
  • CF_DIB
  • CF_BITMAP
  • CF_ENHMETAFILE
Определение того, что объект данных имеет один из этих форматов, не гарантирует успешного создания объекта, но предназначено для упрощения процесса.

Если OleQueryCreateFromData находит один из форматов CF_METAFILEPICT, CF_BITMAP, CF_DIB или CF_ENHMETAFILE, он возвращает OLE_S_STATIC, указывая, что для создания внедренного объекта необходимо вызвать функцию OleCreateStaticFromData .

Если OleQueryCreateFromData находит один из других форматов (CF_EMBEDDEDOBJECT, CF_EMBEDSOURCE или cfFileName), даже в сочетании со статическими форматами, он возвращает S_OK, указывая, что для создания внедренного объекта необходимо вызвать функцию OleCreateFromData .

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header ole2.h
Библиотека Ole32.lib
DLL Ole32.dll
Набор API ext-ms-win-com-ole32-l1-1-3 (появилось в Windows 10 версии 10.0.10240)

См. также раздел

OleCreateFromData

OleCreateStaticFromData

OleQueryLinkFromData