Fungsi OleLoadPicturePath (olectl.h)

Artikel
08/25/2023

Membuat objek gambar baru dan menginisialisasinya dari konten aliran. Ini setara dengan memanggil OleCreatePictureIndirect(NULL, ...) diikuti oleh IPersistStream::Load.

Sintaks

WINOLECTLAPI OleLoadPicturePath(
  [in]  LPOLESTR  szURLorPath,
  [in]  LPUNKNOWN punkCaller,
  [in]  DWORD     dwReserved,
  [in]  OLE_COLOR clrReserved,
  [in]  REFIID    riid,
  [out] LPVOID    *ppvRet
);

Parameter

[in] szURLorPath

Jalur atau URL ke file yang ingin Anda buka.

[in] punkCaller

Menunjuk ke IUnknown untuk agregasi COM.

[in] dwReserved

Dicadangkan.

[in] clrReserved

Warna yang ingin Anda cadangkan agar transparan.

[in] riid

Referensi ke pengidentifikasi antarmuka yang menjelaskan jenis penunjuk antarmuka untuk kembali dalam ppvRet.

[out] ppvRet

Alamat variabel pointer yang menerima pointer antarmuka yang diminta dalam riid. Setelah berhasil dikembalikan, *ppvRet berisi pointer antarmuka yang diminta pada penyimpanan objek yang diidentifikasi oleh moniker. Jika *ppvRetnon-NULL, fungsi ini memanggil IUnknown::AddRef pada antarmuka; adalah tanggung jawab pemanggil untuk memanggil IUnknown::Release. Jika terjadi kesalahan, *ppvRet diatur ke NULL.

Menampilkan nilai

Fungsi ini mendukung nilai pengembalian standar E_OUTOFMEMORY dan E_UNEXPECTED, serta yang berikut:

Menampilkan kode	Deskripsi
S_OK	Kotak dialog berhasil dibuat.
E_FAIL	Tidak dapat memuat aliran gambar.
E_POINTER	Alamat dalam ppvRet adalah NULL.
E_NOINTERFACE	Objek tidak mendukung antarmuka yang ditentukan dalam riid.

Keterangan

Aliran harus dalam format BMP (bitmap), JPEG, WMF (metafile), ICO (ikon), atau GIF.

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

OleLoadPicture

Bagikan melalui