Fungsi OleSave (ole2.h)
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 |
---|---|
|
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.
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) |