Функция OleConvertOLESTREAMToIStorageEx (ole2.h)

Статья
08/25/2023

Функция OleConvertOLESTREAMToIStorageEx преобразует указанный объект из модели хранения OLE 1 в объект структурированного хранилища OLE 2, включая данные представления. Это одна из нескольких функций совместимости.

Синтаксис

HRESULT OleConvertOLESTREAMToIStorageEx(
  [in]  LPOLESTREAM polestm,
  [out] LPSTORAGE   pstg,
  [out] CLIPFORMAT  *pcfFormat,
  [out] LONG        *plwWidth,
  [out] LONG        *plHeight,
  [out] DWORD       *pdwSize,
  [out] LPSTGMEDIUM pmedium
);

Параметры

[in] polestm

Указатель на поток, содержащий постоянное представление объекта в формате хранилища OLE 1.

[out] pstg

Указатель на объект структурированного хранилища OLE 2.

[out] pcfFormat

Указатель на то, где возвращается формат данных презентации. Может иметь значение NULL, указывающее на отсутствие данных представления.

[out] plwWidth

Указатель на то, где возвращается значение ширины (в HIMETRIC) данных презентации.

[out] plHeight

Указатель на то, где возвращается значение высоты (в HIMETRIC) данных презентации.

[out] pdwSize

Указатель на то, где возвращается размер преобразованных данных в байтах.

[out] pmedium

Указатель на то, где возвращается структура STGMEDIUM для преобразованных сериализованных данных.

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

Эта функция возвращает HRESULT.

Эта функция преобразует объект OLE 1 в объект структурированного хранилища OLE 2. Эту функцию можно использовать для обновления объектов OLE 1 до объектов OLE 2, если новая версия объектного приложения поддерживает OLE 2.

Эта функция отличается от функции OleConvertOLESTREAMToIStorage тем, что данные презентации, считываемые из структуры OLESTREAM , передаются, а созданный объект хранилища OLE 2 не содержит поток представления.

Так как эта функция может указать, какие данные представления следует преобразовать, ее могут использовать приложения, которые не используют ресурсы кэширования OLE по умолчанию, но используют ресурсы преобразования.

Элемент tymedstGMEDIUM может быть только TYMED_NULL или TYMED_ISTREAM. Если это TYMED_NULL, данные будут возвращены в глобальный дескриптор через элемент hGlobalSTGMEDIUM, в противном случае данные будут записаны в элемент pstm этой структуры.

Требования

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