Fungsi OleSave (ole2.h)

Artikel
02/29/2024

Menyimpan objek yang dibuka dalam mode yang ditransaksikan ke objek penyimpanan yang ditentukan.

Sintaks

HRESULT OleSave(
  [in] LPPERSISTSTORAGE pPS,
  [in] LPSTORAGE        pStg,
  [in] BOOL             fSameAsLoad
);

Parameter

[in] pPS

Arahkan ke antarmuka IPersistStorage pada objek yang akan disimpan.

[in] pStg

Penunjuk ke antarmuka IStorage pada objek penyimpanan tujuan tempat objek yang ditunjukkan dalam pPS akan disimpan.

[in] fSameAsLoad

TRUE menunjukkan bahwa pStg adalah objek penyimpanan yang sama tempat objek dimuat atau dibuat; FALSE menunjukkan bahwa pStg dimuat atau dibuat dari objek penyimpanan yang berbeda.

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. Fungsi ini juga dapat mengembalikan salah satu nilai kesalahan yang dikembalikan oleh metode IPersistStorage::Save .

Keterangan

Fungsi pembantu OleSave menangani situasi umum di mana objek terbuka dalam mode bertransaksi dan kemudian disimpan ke dalam objek penyimpanan yang ditentukan yang menggunakan implementasi file majemuk yang disediakan OLE. Mode yang ditransaksikan berarti bahwa perubahan pada objek di-buffer hingga salah satu IStorage::Commit atau IStorage::Revert dipanggil. Penelepon dapat menangani situasi lain dengan memanggil antarmuka IPersistStorage dan IStorage secara langsung.

OleSave melakukan hal berikut:

Memanggil metode IPersist::GetClassID untuk mendapatkan CLSID objek.
Menulis CLSID ke objek penyimpanan menggunakan fungsi WriteClassStg .
Memanggil metode IPersistStorage::Save untuk menyimpan objek.
Jika tidak ada kesalahan pada penyimpanan; memanggil metode IStorage::Commit untuk menerapkan perubahan.

Catatan Objek statis disimpan ke dalam aliran yang disebut CONTENTS. Objek metafile statis disimpan dalam "format metafile yang dapat ditempatkan" dan data DIB statis disimpan dalam "format file DIB." Format ini didefinisikan sebagai standar OLE untuk metafile dan DIB. Semua data yang ditransfer menggunakan antarmuka IStream atau file (yaitu, melalui IDataObject::GetDataHere) harus dalam format ini. Selain itu, semua objek yang format file defaultnya adalah metafile atau DIB harus menulis data mereka ke dalam aliran CONTENTS menggunakan format standar 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
Set API	ext-ms-win-com-ole32-l1-1-3 (diperkenalkan dalam Windows 10, versi 10.0.10240)

Lihat juga

IPersistStorage

IStorage

Bagikan melalui