Fungsi OleLoad (ole2.h)

Artikel
08/25/2023

Memuat ke dalam memori objek yang ditumpuk dalam objek penyimpanan tertentu.

Sintaks

HRESULT OleLoad(
  [in]  LPSTORAGE       pStg,
  [in]  REFIID          riid,
  [in]  LPOLECLIENTSITE pClientSite,
  [out] LPVOID          *ppvObj
);

Parameter

[in] pStg

Arahkan ke antarmuka IStorage pada objek penyimpanan tempat memuat objek yang ditentukan.

[in] riid

Referensi ke pengidentifikasi antarmuka yang ingin digunakan pemanggil untuk berkomunikasi dengan objek setelah dimuat.

[in] pClientSite

Arahkan ke antarmuka IOleClientSite pada objek situs klien yang sedang dimuat.

[out] ppvObj

Alamat variabel pointer yang menerima pointer antarmuka yang diminta dalam riid. Setelah berhasil dikembalikan, *ppvObj berisi penunjuk antarmuka yang diminta pada objek yang baru dimuat.

Menampilkan nilai

Fungsi ini mengembalikan S_OK pada keberhasilan. Nilai lain yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
E_NOINTERFACE	Objek tidak mendukung antarmuka yang ditentukan.

Selain itu, fungsi ini dapat mengembalikan salah satu nilai kesalahan yang dikembalikan oleh metode IPersistStorage::Load .

Keterangan

Kontainer OLE memuat objek ke dalam memori dengan memanggil fungsi ini. Saat memanggil fungsi OleLoad , aplikasi kontainer meneruskan penunjuk ke objek penyimpanan terbuka tempat objek berlapis disimpan. Biasanya, objek berlapis yang akan dimuat adalah objek penyimpanan anak ke objek penyimpanan akar kontainer. Dengan menggunakan informasi OLE yang disimpan dengan objek , handler objek (biasanya, handler default) mencoba memuat objek. Setelah menyelesaikan fungsi OleLoad , objek dikatakan dalam keadaan dimuat dengan aplikasi objeknya tidak berjalan.

Beberapa aplikasi memuat semua data asli objek. Kontainer sering menuangkan pemuatan objek yang terkandung sampai diperlukan untuk melakukannya. Misalnya, hingga objek digulir ke dalam tampilan dan perlu digambar, objek tidak perlu dimuat.

Fungsi OleLoad melakukan langkah-langkah berikut:

Jika perlu, lakukan konversi otomatis objek (lihat fungsi OleDoAutoConvert ).
Mendapatkan CLSID dari objek penyimpanan terbuka dengan memanggil metode IStorage::Stat .
Memanggil fungsi CoCreateInstance untuk membuat instans handler. Jika kode handler tidak tersedia, handler default digunakan (lihat fungsi OleCreateDefaultHandler ).
Memanggil metode IOleObject::SetClientSite dengan parameter pClientSite untuk menginformasikan objek situs kliennya.
Memanggil metode QueryInterface untuk antarmuka IPersistStorage . Jika berhasil, metode IPersistStorage::Load dipanggil untuk objek .
Mengkueri dan mengembalikan antarmuka yang diidentifikasi oleh parameter riid .

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	ole2.h
Pustaka	Ole32.lib
DLL	Ole32.dll

Bagikan melalui