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

Статья
08/25/2023

Создает объект picture и инициализирует его из содержимого потока. Это эквивалентно вызову OleCreatePictureIndirect с null в качестве первого параметра, за которым следует вызов IPersistStream::Load.

Синтаксис

WINOLECTLAPI OleLoadPicture(
  [in]  LPSTREAM lpstream,
  [in]  LONG     lSize,
  [in]  BOOL     fRunmode,
  [in]  REFIID   riid,
  [out] LPVOID   *lplpvObj
);

Параметры

[in] lpstream

Указатель на поток, содержащий данные рисунка.

[in] lSize

Количество байтов, которые должны быть считаны из потока, или ноль, если весь поток должен быть прочитан.

[in] fRunmode

Противоположность начальному значению свойства KeepOriginalFormat . Если задано значение TRUE, параметру KeepOriginalFormat присваивается значение FALSE и наоборот.

[in] riid

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

[out] lplpvObj

Адрес переменной указателя, которая получает указатель интерфейса, запрошенный в riid. После успешного возврата *ppvObj содержит запрошенный указатель интерфейса на хранилище объекта, определяемого моникером. Если значение *ppvObj не равно NULL, эта функция вызывает IUnknown::AddRef в интерфейсе ; за вызов IUnknown::Release отвечает вызывающий объект. При возникновении ошибки параметру *ppvObj присваивается значение NULL.

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

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

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

Поток должен быть в формате BMP (растровое изображение), WMF (метафайл) или ICO (значок). Объект рисунка, созданный с помощью OleLoadPicture , всегда владеет своими внутренними ресурсами (подразумевается fOwn==TRUE ).

Требования


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

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

OleCreatePictureIndirect

PICTDESC

Share via