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


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

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

Синтаксис

WINOLECTLAPI OleLoadPicturePath(
  [in]  LPOLESTR  szURLorPath,
  [in]  LPUNKNOWN punkCaller,
  [in]  DWORD     dwReserved,
  [in]  OLE_COLOR clrReserved,
  [in]  REFIID    riid,
  [out] LPVOID    *ppvRet
);

Параметры

[in] szURLorPath

Путь или URL-адрес файла, который требуется открыть.

[in] punkCaller

Указывает на IUnknown для агрегирования COM.

[in] dwReserved

Зарезервировано.

[in] clrReserved

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

[in] riid

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

[out] ppvRet

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

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

Эта функция поддерживает стандартные возвращаемые значения E_OUTOFMEMORY и E_UNEXPECTED, а также следующие:

Код возврата Описание
S_OK
Диалоговое окно создано успешно.
E_FAIL
Не удается загрузить поток рисунков.
E_POINTER
Адрес в ppvRet имеет значение NULL.
E_NOINTERFACE
Объект не поддерживает интерфейс, указанный в riid.

Комментарии

Поток должен быть в формате BMP (растровое изображение), JPEG, WMF (метафайл), ICO (значок) или GIF.

Требования

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

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

OleLoadPicture