Fungsi OleLoadFromStream (ole2.h)

Artikel
08/25/2023

Memuat objek dari aliran.

Sintaks

HRESULT OleLoadFromStream(
  [in]  LPSTREAM pStm,
  [in]  REFIID   iidInterface,
  [out] LPVOID   *ppvObj
);

Parameter

[in] pStm

Arahkan ke antarmuka IStream pada aliran tempat objek akan dimuat.

[in] iidInterface

Pengidentifikasi antarmuka (IID) yang ingin digunakan pemanggil untuk berkomunikasi dengan objek setelah 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.

Nilai kembali

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

Menampilkan kode	Deskripsi
E_OUTOFMEMORY	Memori untuk operasi tidak cukup.
E_NOINTERFACE	Objek tidak mendukung antarmuka yang ditentukan.

Fungsi ini juga dapat mengembalikan salah satu nilai kesalahan yang dikembalikan oleh fungsi ReadClassStm dan CoCreateInstance , dan metode IPersistStream::Load .

Keterangan

Penting

Catatan Keamanan: Memanggil metode ini dengan data yang tidak tepercaya adalah risiko keamanan. Panggil metode ini hanya dengan data tepercaya.

Fungsi ini dapat digunakan untuk memuat objek yang mendukung antarmuka IPersistStream . CLSID objek harus segera mendahului data objek dalam aliran, yang dicapai oleh fungsi pendamping OleSaveToStream (atau operasi yang dibungkusnya, yang dijelaskan di bawah topik tersebut).

Jika CLSID untuk aliran CLSID_NULL, parameter ppvObj diatur ke NULL.

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 (termasuk Ole2.h)
Pustaka	Ole32.lib
DLL	Ole32.dll
Set API	ext-ms-win-com-ole32-l1-1-5 (diperkenalkan dalam Windows 10, versi 10.0.15063)

Lihat juga

OleSaveToStream

Bagikan melalui