Функция OleCreatePictureIndirect (olectl.h)

Статья
08/25/2023

Создает новый объект рисунка, инициализированный в соответствии со структурой PICTDESC .

Синтаксис

WINOLECTLAPI OleCreatePictureIndirect(
  [in]  LPPICTDESC lpPictDesc,
  [in]  REFIID     riid,
  [in]  BOOL       fOwn,
  [out] LPVOID     *lplpvObj
);

Параметры

[in] lpPictDesc

Указатель на структуру, выделенную вызывающим объектом, содержащую начальное состояние рисунка. Указанная структура может иметь значение NULL для создания неинициализированного объекта в случае, если рисунок необходимо инициализировать с помощью IPersistStream::Load.

[in] riid

Ссылка на идентификатор интерфейса, описывающий тип возвращаемого указателя интерфейса в lplpvObj.

[in] fOwn

Если задано значение TRUE, объект рисунка уничтожает свой рисунок при уничтожении объекта. Если значение FALSE, вызывающий объект отвечает за уничтожение рисунка.

[out] lplpvObj

Адрес переменной указателя, получающей указатель интерфейса, запрошенный в riid. После успешного возврата этот параметр содержит запрошенный указатель интерфейса на вновь созданный объект. Если вызов выполнен успешно, вызывающий объект отвечает за вызов release через указатель этого интерфейса, когда новый объект больше не нужен. Если вызов завершается сбоем, устанавливается значение NULL.

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

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

Код возврата	Описание
E_NOINTERFACE	Объект не поддерживает интерфейс, указанный в riid.
E_POINTER	Недопустимый адрес в pPictDesc или lplpvObj . Например, он может иметь значение NULL.

Параметр fOwn указывает, является ли рисунок владельцем дескриптора рисунка GDI для содержащегося в нем рисунка, чтобы объект рисунка уничтожил свой рисунок при уничтожении самого объекта. Функция возвращает указатель интерфейса на новый объект рисунка, заданный вызывающим объектом в параметре riid . QueryInterface встроен в этот вызов. Вызывающий объект отвечает за вызов Release через возвращенный указатель интерфейса.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	olectl.h
Библиотека	OleAut32.lib
DLL	OleAut32.dll

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

OleLoadPicture

PICTDESC

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