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

Статья
03/05/2024

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

Синтаксис

HRESULT OleConvertIStorageToOLESTREAMEx(
  [in]  LPSTORAGE   pstg,
  [in]  CLIPFORMAT  cfFormat,
  [in]  LONG        lWidth,
  [in]  LONG        lHeight,
  [in]  DWORD       dwSize,
  [in]  LPSTGMEDIUM pmedium,
  [out] LPOLESTREAM polestm
);

Параметры

[in] pstg

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

[in] cfFormat

Формат данных презентации. Может иметь значение NULL. В этом случае параметры lWidth, lHeight, dwSize и pmedium игнорируются.

[in] lWidth

Ширина данных представления объекта в единицах HIMETRIC.

[in] lHeight

Высота данных представления объекта в единицах HIMETRIC.

[in] dwSize

Размер преобразуемых данных в байтах.

[in] pmedium

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

[out] polestm

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

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

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

Функция OleConvertIStorageToOLESTREAMEx преобразует объект хранилища OLE 2 в формат OLE 1. Она отличается от функции OleConvertIStorageToOLESTREAM тем, что функция OleConvertIStorageToOLESTREAMEx также передает данные презентации в объект хранения OLE 1, а функция OleConvertIStorageToOLESTREAM — нет.

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

Значение элементаSTGMEDIUM должно быть TYMED_HGLOBAL или TYMED_ISTREAM; Дополнительные сведения см. в перечислении TYMED . Среда не освобождается функцией OleConvertIStorageToOLESTREAMEx .

Требования

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