Fungsi OleCreatePictureIndirect (olectl.h)

Artikel
03/04/2024

Membuat objek gambar baru yang diinisialisasi sesuai dengan struktur PICTDESC .

Sintaks

WINOLECTLAPI OleCreatePictureIndirect(
  [in]  LPPICTDESC lpPictDesc,
  [in]  REFIID     riid,
  [in]  BOOL       fOwn,
  [out] LPVOID     *lplpvObj
);

Parameter

[in] lpPictDesc

Penunjuk ke struktur yang dialokasikan penelepon yang berisi status awal gambar. Struktur yang ditentukan dapat berupa NULL untuk membuat objek yang tidak diinisialisasi, jika gambar perlu diinisialisasi melalui IPersistStream::Load.

[in] riid

Referensi ke pengidentifikasi antarmuka yang menjelaskan jenis penunjuk antarmuka untuk dikembalikan dalam lplpvObj.

[in] fOwn

Jika TRUE, objek gambar adalah untuk menghancurkan gambarnya ketika objek dihancurkan. Jika FALSE, pemanggil bertanggung jawab untuk menghancurkan gambar.

[out] lplpvObj

Alamat variabel pointer yang menerima pointer antarmuka yang diminta dalam riid. Setelah berhasil dikembalikan, parameter ini berisi penunjuk antarmuka yang diminta pada objek yang baru dibuat. Jika panggilan berhasil, pemanggil bertanggung jawab untuk memanggil Rilis melalui penunjuk antarmuka ini ketika objek baru tidak lagi diperlukan. Jika panggilan gagal, nilai diatur ke NULL.

Nilai kembali

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 dalam riid.
E_POINTER	Alamat dalam pPictDesc atau lplpvObj tidak valid. Misalnya, mungkin NULL.

Keterangan

Parameter fOwn menunjukkan apakah gambar adalah untuk memiliki handel gambar GDI untuk gambar yang dikandungnya, sehingga objek gambar akan menghancurkan gambarnya ketika objek itu sendiri dihancurkan. Fungsi mengembalikan penunjuk antarmuka ke objek gambar baru yang ditentukan oleh pemanggil dalam parameter riid . QueryInterface disertakan dalam panggilan ini. Pemanggil bertanggung jawab untuk memanggil Rilis melalui penunjuk antarmuka yang dikembalikan.

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	olectl.h
Pustaka	OleAut32.lib
DLL	OleAut32.dll

Lihat juga

OleLoadPicture

PICTDESC