Функция OleLoadPicture (olectl.h)
Создает объект 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 об успешном выполнении. Ниже перечислены другие возможные значения.
| Код возврата | Описание |
|---|---|
|
Объект не поддерживает указанный интерфейс. |
|
Поток недопустим. Например, он может иметь значение NULL. |
Комментарии
Поток должен быть в формате BMP (растровое изображение), WMF (метафайл) или ICO (значок). Объект рисунка, созданный с помощью OleLoadPicture , всегда владеет своими внутренними ресурсами (подразумевается fOwn==TRUE ).
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | olectl.h |
| Библиотека | OleAut32.lib |
| DLL | OleAut32.dll |