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