IPersistFile::Muat metode (objidl.h)

Artikel
03/13/2024

Membuka file yang ditentukan dan menginisialisasi objek dari isi file.

Sintaks

HRESULT Load(
  [in] LPCOLESTR pszFileName,
  [in] DWORD     dwMode
);

Parameter

[in] pszFileName

Jalur absolut file yang akan dibuka.

[in] dwMode

Mode akses yang akan digunakan saat membuka file. Nilai yang mungkin diambil dari enumerasi STGM . Metode ini dapat memperlakukan nilai ini sebagai saran, menambahkan izin yang lebih ketat jika perlu. Jika dwMode adalah 0, implementasi harus membuka file menggunakan izin default apa pun yang digunakan saat pengguna membuka file.

Nilai kembali

Metode ini dapat mengembalikan nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil diselesaikan.
E_OUTOFMEMORY	Objek tidak dapat dimuat karena kurangnya memori.
E_FAIL	Objek tidak dapat dimuat karena alasan tertentu selain kurangnya memori.

Keterangan

IPersistFile::Load memuat objek dari file yang ditentukan. Metode ini hanya untuk inisialisasi dan tidak menampilkan objek kepada pengguna akhir. Ini tidak setara dengan apa yang terjadi ketika pengguna memilih perintah Buka File .

Catatan untuk Penelepon

Metode BindToObject dalam moniker file memanggil metode ini untuk memuat objek selama operasi pengikatan moniker (saat objek tertaut dijalankan). Biasanya, aplikasi tidak memanggil metode ini secara langsung.

Catatan untuk Pelaksana

Karena informasi yang diperlukan untuk membuka file sangat bervariasi dari satu aplikasi ke aplikasi lainnya, objek tempat metode ini diterapkan juga harus membuka file yang ditentukan oleh parameter pszFileName . Ini berbeda dari IPersistStorage::Load dan IPersistStream::Load, di mana penelepon membuka penyimpanan atau streaming lalu meneruskan penyimpanan terbuka atau penunjuk aliran ke objek yang dimuat.

Untuk aplikasi yang biasanya menggunakan file senyawa OLE, implementasi IPersistFile::Load Anda cukup memanggil fungsi StgOpenStorage untuk membuka objek penyimpanan dalam file yang ditentukan. Kemudian, Anda dapat melanjutkan dengan inisialisasi normal. Aplikasi yang tidak menggunakan objek penyimpanan dapat melakukan prosedur pembukaan file normal.

Ketika objek telah dimuat, implementasi Anda harus mendaftarkan objek dalam tabel objek yang sedang berjalan (lihat IRunningObjectTable::Register).

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