Fungsi OleConvertIStorageToOLESTREAMEx (ole2.h)

Artikel
02/29/2024

Fungsi OleConvertIStorageToOLESTREAMEx mengonversi objek penyimpanan yang ditentukan dari penyimpanan terstruktur OLE 2 ke model objek penyimpanan OLE 1, termasuk data presentasi. Ini adalah salah satu dari beberapa fungsi yang disertakan dalam Penyimpanan Terstruktur untuk memastikan kompatibilitas antara OLE1 dan OLE2.

Sintaks

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

Parameter

[in] pstg

Arahkan ke antarmuka IStorage pada objek penyimpanan yang akan dikonversi ke penyimpanan OLE 1.

[in] cfFormat

Format data presentasi. Mungkin NULL, dalam hal ini parameter lWidth, lHeight, dwSize, dan pmedium diabaikan.

[in] lWidth

Lebar data presentasi objek di unit HIMETRIC.

[in] lHeight

Tinggi data presentasi objek di unit HIMETRIC.

[in] dwSize

Ukuran data, dalam byte, yang akan dikonversi.

[in] pmedium

Arahkan ke struktur STGMEDIUM agar data serial dikonversi.

[out] polestm

Penunjuk ke aliran tempat representasi persisten objek disimpan menggunakan model penyimpanan OLE 1.

Nilai kembali

Fungsi ini mendukung nilai pengembalian standar E_INVALIDARG, selain yang berikut:

Keterangan

Fungsi OleConvertIStorageToOLESTREAMEx mengonversi objek penyimpanan OLE 2 ke format OLE 1. Ini berbeda dari fungsi OleConvertIStorageToOLESTREAM karena fungsi OleConvertIStorageToOLESTREAMEx juga meneruskan data presentasi ke objek penyimpanan OLE 1, sedangkan fungsi OleConvertIStorageToOLESTREAM tidak.

Karena OleConvertIStorageToOLESTREAMEx dapat menentukan data presentasi mana yang akan dikonversi, itu dapat digunakan oleh aplikasi yang tidak menggunakan sumber daya penembolokan default OLE tetapi menggunakan sumber daya konversi OLE.

Nilai anggota tymedSTGMEDIUM harus TYMED_HGLOBAL atau TYMED_ISTREAM; lihat enumerasi TYMED untuk informasi selengkapnya. Media tidak dirilis oleh fungsi OleConvertIStorageToOLESTREAMEx .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	ole2.h
Pustaka	Ole32.lib
DLL	Ole32.dll