IPersistStreamInit::Metode simpan (ocidl.h)

Artikel
08/25/2023

Menyimpan objek ke aliran yang ditentukan.

Sintaks

HRESULT Save(
  [in] LPSTREAM pStm,
  [in] BOOL     fClearDirty
);

Parameter

[in] pStm

Penunjuk IStream ke aliran tempat objek harus disimpan.

[in] fClearDirty

Menunjukkan apakah akan menghapus bendera kotor setelah penyimpanan selesai. Jika TRUE, bendera harus dibersihkan. Jika FALSE, bendera harus dibiarkan tidak berubah.

Mengembalikan nilai

Metode ini dapat mengembalikan nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil diselesaikan.
STG_E_CANTSAVE	Objek tidak dapat menyimpan dirinya ke aliran. Kesalahan ini dapat menunjukkan, misalnya, bahwa objek berisi objek lain yang tidak dapat diserialisasikan ke aliran atau bahwa panggilan ISequentialStream::Write dikembalikan STG_E_CANTSAVE.
STG_E_MEDIUMFULL	Objek tidak dapat disimpan karena tidak ada ruang yang tersisa pada perangkat penyimpanan.

Keterangan

IPersistStreamInit::Save menyimpan objek ke dalam aliran yang ditentukan dan menunjukkan apakah objek harus mengatur ulang bendera kotornya.

Penunjuk pencarian diposisikan di lokasi di aliran tempat objek harus mulai menulis datanya. Objek memanggil metode ISequentialStream::Write untuk menulis datanya.

Saat keluar, penunjuk pencarian harus diposisikan segera melewati data objek. Posisi penunjuk pencarian tidak terdefinisi jika kesalahan kembali.

Catatan untuk Pelaksana

Metode IPersistStreamInit::Save tidak menulis CLSID ke aliran. Penelepon bertanggung jawab untuk menulis CLSID.

Metode IPersistStreamInit::Save dapat membaca dari, menulis ke, dan mencari di aliran; tetapi tidak boleh mencari lokasi di aliran sebelum penunjuk pencarian pada entri.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	ocidl.h

Lihat juga

IPersistStreamInit

Bagikan melalui