Fungsi OleConvertOLESTREAMToIStorageEx (ole2.h)

Artikel
02/29/2024

Fungsi OleConvertOLESTREAMToIStorageEx mengonversi objek yang ditentukan dari model penyimpanan OLE 1 ke objek penyimpanan terstruktur OLE 2 termasuk data presentasi. Ini adalah salah satu dari beberapa fungsi kompatibilitas.

Sintaks

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

Parameter

[in] polestm

Penunjuk ke aliran yang berisi representasi persisten objek dalam format penyimpanan OLE 1.

[out] pstg

Arahkan ke objek penyimpanan terstruktur OLE 2.

[out] pcfFormat

Penunjuk ke tempat format data presentasi dikembalikan. Mungkin NULL, menunjukkan tidak adanya data presentasi.

[out] plwWidth

Penunjuk ke tempat nilai lebar (dalam HIMETRIC) data presentasi dikembalikan.

[out] plHeight

Penunjuk ke tempat nilai tinggi (dalam HIMETRIC) data presentasi dikembalikan.

[out] pdwSize

Penunjuk ke tempat ukuran dalam byte data yang dikonversi dikembalikan.

[out] pmedium

Pointer ke tempat struktur STGMEDIUM untuk data serial yang dikonversi dikembalikan.

Nilai kembali

Fungsi ini mengembalikan HRESULT.

Keterangan

Fungsi ini mengonversi objek OLE 1 menjadi objek penyimpanan terstruktur OLE 2. Anda dapat menggunakan fungsi ini untuk memperbarui objek OLE 1 ke objek OLE 2 saat versi baru aplikasi objek mendukung OLE 2.

Fungsi ini berbeda dari fungsi OleConvertOLESTREAMToIStorage di mana data presentasi yang dibaca dari struktur OLESTREAM dilewatkan dan objek penyimpanan OLE 2 yang baru dibuat tidak berisi aliran presentasi.

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

Anggota TymedSTGMEDIUM hanya dapat TYMED_NULL atau TYMED_ISTREAM. Jika TYMED_NULL, data akan dikembalikan dalam handel global melalui anggota hGlobalSTGMEDIUM, jika tidak, data akan ditulis ke dalam anggota pstm struktur ini.

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