Fungsi OleLoadPicture (olectl.h)

Artikel
08/25/2023

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
E_NOINTERFACE	Objek tidak mendukung antarmuka yang ditentukan.
E_POINTER	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

Lihat juga

OleCreatePictureIndirect

PICTDESC