Fungsi OleSaveToStream (ole.h)

Menyimpan objek dengan antarmuka IPersistStream di atasnya ke aliran yang ditentukan.

Sintaks

OLESTATUS OleSaveToStream(
  LPOLEOBJECT unnamedParam1,
  LPOLESTREAM unnamedParam2
);

Parameter

unnamedParam1

Arahkan ke antarmuka IPersistStream pada objek yang akan disimpan ke aliran. Parameter pPStm tidak boleh NULL.

unnamedParam2

Penunjuk ke antarmuka IStream pada aliran tempat objek akan disimpan.

Nilai kembali

Fungsi ini mengembalikan S_OK pada keberhasilan. Nilai lain yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
STGMEDIUM_E_FULL	Objek tidak dapat disimpan karena kurangnya ruang disk.
OLE_E_BLANK	Parameter pPStm adalah NULL.

 

Fungsi ini juga dapat mengembalikan salah satu nilai kesalahan yang dikembalikan oleh fungsi WriteClassStm atau metode IPersistStream::Save .

Keterangan

Fungsi ini menyederhanakan penyimpanan objek yang mengimplementasikan antarmuka IPersistStream ke aliran. Dalam aliran ini, CLSID objek mendahului datanya. Ketika aliran diambil, CLSID mengizinkan kode yang tepat untuk dikaitkan dengan data. Fungsi OleSaveToStream melakukan hal berikut:

• Memanggil metode IPersist::GetClassID untuk mendapatkan CLSID objek.
• Menulis CLSID ke aliran dengan fungsi WriteClassStm .
• Memanggil metode IPersistStream::Save dengan fClearDirty diatur ke TRUE, yang menghapus bit kotor dalam objek.

Pembantu pendamping, OleLoadFromStream, memuat objek yang disimpan dengan cara 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	ole.h (termasuk Ole2.h)
Pustaka	Ole32.lib
DLL	Ole32.dll
Set API	ext-ms-win-com-ole32-l1-1-1 (diperkenalkan dalam Windows 8.1)

Lihat juga

IPersistStream

IStream

OleLoadFromStream