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

Статья
08/25/2023

Создает объект 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.

Требования


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

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

OleLoadPicture