Share via

IPersistStream::Muat metode (objidl.h)

  • Artikel

Menginisialisasi objek dari aliran tempat objek disimpan sebelumnya.

Sintaks

HRESULT Load(
  [in] IStream *pStm
);

Parameter

[in] pStm

Penunjuk IStream ke aliran tempat objek harus dimuat.

Nilai kembali

Metode ini dapat mengembalikan nilai berikut.

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

Keterangan

Metode ini memuat objek dari aliran terkait. Penunjuk pencarian diatur seperti yang ada di metode IPersistStream::Save terbaru. Metode ini dapat mencari dan membaca dari aliran, tetapi tidak dapat menulis ke dalamnya.

Catatan untuk Penelepon

Daripada memanggil IPersistStream::Load secara langsung, Anda biasanya memanggil fungsi OleLoadFromStream melakukan hal berikut:
  1. Memanggil fungsi ReadClassStm untuk mendapatkan pengidentifikasi kelas dari aliran.
  2. Memanggil fungsi CoCreateInstance untuk membuat instans objek.
  3. Mengkueri instans untuk IPersistStream.
  4. Memanggil IPersistStream::Load.
Fungsi OleLoadFromStream mengasumsikan bahwa objek disimpan dalam aliran dengan pengidentifikasi kelas diikuti oleh data objek. Pola penyimpanan ini digunakan oleh implementasi generik composite-moniker yang disediakan oleh OLE.

Jika objek tidak disimpan menggunakan pola ini, Anda harus memanggil metode secara terpisah sendiri.

Catatan Moniker URL

Menginisialisasi moniker URL dari data dalam aliran, biasanya disimpan di sana sebelumnya menggunakan IPersistStream::Save (menggunakan OleSaveToStream). Format biner url moniker adalah string URL-nya di Unicode (mungkin string URL lengkap atau parsial, lihat CreateURLMonikerEx untuk detailnya). Ini direpresentasikan sebagai jumlah karakter ULONG diikuti oleh banyak karakter Unicode.

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

IPersistStream