Fungsi OleLoadPicture (olectl.h)
Membuat objek gambar baru dan menginisialisasinya dari konten aliran. Ini setara dengan memanggil OleCreatePictureIndirect dengan NULL sebagai parameter pertama, diikuti dengan panggilan ke IPersistStream::Load.
Sintaks
WINOLECTLAPI OleLoadPicture(
[in] LPSTREAM lpstream,
[in] LONG lSize,
[in] BOOL fRunmode,
[in] REFIID riid,
[out] LPVOID *lplpvObj
);
Parameter
[in] lpstream
Arahkan ke aliran yang berisi data gambar.
[in] lSize
Jumlah byte yang harus dibaca dari aliran, atau nol jika seluruh aliran harus dibaca.
[in] fRunmode
Kebalikan dari nilai awal properti KeepOriginalFormat . Jika TRUE, KeepOriginalFormat diatur ke FALSE dan sebaliknya.
[in] riid
Referensi ke pengidentifikasi antarmuka yang menjelaskan jenis penunjuk antarmuka untuk kembali dalam ppvObj.
[out] lplpvObj
Alamat variabel pointer yang menerima pointer antarmuka yang diminta dalam riid. Setelah berhasil dikembalikan, *ppvObj berisi penunjuk antarmuka yang diminta pada penyimpanan objek yang diidentifikasi oleh moniker. Jika *ppvObjnon-NULL, fungsi ini memanggil IUnknown::AddRef pada antarmuka; adalah tanggung jawab penelepon untuk memanggil IUnknown::Release. Jika terjadi kesalahan, *ppvObj diatur ke NULL.
Menampilkan nilai
Fungsi ini mengembalikan S_OK pada keberhasilan. Nilai lain yang mungkin termasuk yang berikut ini.
| Menampilkan kode | Deskripsi |
|---|---|
|
Objek tidak mendukung antarmuka yang ditentukan. |
|
Aliran tidak valid. Misalnya, mungkin NULL. |
Keterangan
Aliran harus dalam format BMP (bitmap), WMF (metafile), atau ICO (ikon). Objek gambar yang dibuat menggunakan OleLoadPicture selalu memiliki kepemilikan atas sumber daya internalnya (fOwn==TRUE tersirat).
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 | olectl.h |
| Pustaka | OleAut32.lib |
| DLL | OleAut32.dll |