IPersistFile::Simpan metode (objidl.h)

Artikel
02/29/2024

Menyimpan salinan objek ke file yang ditentukan.

Sintaks

HRESULT Save(
  [in] LPCOLESTR pszFileName,
  [in] BOOL      fRemember
);

Parameter

[in] pszFileName

Jalur absolut file tempat objek harus disimpan. Jika pszFileNameADALAH NULL, objek harus menyimpan datanya ke file saat ini, jika ada.

[in] fRemember

Menunjukkan apakah parameter pszFileName akan digunakan sebagai file kerja saat ini. Jika TRUE, pszFileName menjadi file saat ini dan objek harus menghapus bendera kotornya setelah penyimpanan. Jika FALSE, operasi penyimpanan ini adalah operasi Simpan Salinan Sebagai ... . Dalam hal ini, file saat ini tidak berubah dan objek tidak boleh menghapus bendera kotornya. Jika pszFileNameADALAH NULL, implementasi harus mengabaikan bendera fRemember .

Mengembalikan nilai

Jika objek berhasil disimpan, nilai yang dikembalikan S_OK. Jika tidak, itu S_FALSE. Metode ini juga dapat mengembalikan berbagai kesalahan penyimpanan.

Keterangan

Metode ini dapat dipanggil untuk menyimpan objek ke file yang ditentukan dengan salah satu dari tiga cara:

Pelaksana harus mendeteksi jenis operasi penyimpanan mana yang diminta pemanggil. Jika parameter pszFileNameadalah NULL, Simpan sedang diminta. Jika parameter pszFileName bukan NULL, gunakan nilai parameter fRemember untuk membedakan antara Simpan Sebagai dan Simpan Salinan Sebagai.

Di operasi Simpan atau Simpan Sebagai , IPersistFile::Simpan menghapus bendera kotor internal setelah menyimpan dan mengirim pemberitahuan IAdviseSink::OnSave ke koneksi saran apa pun (lihat juga IOleAdviseHolder::SendOnSave). Selain itu, dalam operasi ini, objek berada dalam mode NoScribble hingga menerima panggilan IPersistFile::SaveCompleted . Dalam mode NoScribble, objek tidak boleh menulis ke file.

Dalam skenario Simpan Sebagai , implementasi juga harus mengirim pemberitahuan IAdviseSink::OnRename ke koneksi saran apa pun (lihat juga IOleAdviseHolder::SendOnRename).

Dalam skenario Simpan Salin Sebagai , implementasi tidak menghapus bendera kotor internal setelah penyimpanan.

Catatan untuk Penelepon

OLE tidak memanggil IPersistFile::Save. Biasanya, aplikasi tidak akan memanggilnya kecuali mereka menyimpan objek ke file secara langsung, yang umumnya diserahkan ke pengguna akhir.

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	objidl.h

Lihat juga

IPersistFile

Bagikan melalui