Fungsi OleSaveToStream (ole2.h)
Menyimpan objek dengan antarmuka IPersistStream di atasnya ke aliran yang ditentukan.
Sintaks
HRESULT OleSaveToStream(
[in] LPPERSISTSTREAM pPStm,
[in] LPSTREAM pStm
);
Parameter
[in] pPStm
Arahkan ke antarmuka IPersistStream pada objek yang akan disimpan ke aliran. Parameter pPStm tidak boleh NULL.
[in] pStm
Arahkan 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 |
---|---|
|
Objek tidak dapat disimpan karena kurangnya ruang disk. |
|
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. Saat 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.
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 (termasuk Ole2.h) |
Pustaka | Ole32.lib |
DLL | Ole32.dll |
Set API | ext-ms-win-com-ole32-l1-1-1 (diperkenalkan dalam Windows 8.1) |