fungsi ImageList_CoCreateInstance (commoncontrols.h)

Membuat satu instans daftar gambar dan mengembalikan penunjuk antarmuka ke dalamnya.

Sintaks

HRESULT ImageList_CoCreateInstance(
  [in]           REFCLSID       rclsid,
  [in, optional] const IUnknown *punkOuter,
  [in]           REFIID         riid,
  [out]          void           **ppv
);

Parameter

[in] rclsid

Jenis: REFCLSID

Referensi ke CLSID—GUID yang mengidentifikasi objek COM yang akan dibuat. Ini harus CLSID_ImageList.

[in, optional] punkOuter

Jenis: const IUnknown*

Penunjuk ke antarmuka IUnknown luar yang menggabungkan objek yang dibuat oleh fungsi ini, atau NULL jika tidak ada agregasi yang diinginkan.

[in] riid

Jenis: REFIID

Referensi ke ID antarmuka yang diinginkan.

[out] ppv

Jenis: void**

Ketika metode ini kembali, berisi pointer antarmuka yang diminta dalam riid. Ini biasanya IImageList2, yang menyediakan metode Inisialisasi .

Menampilkan nilai

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Sebelum memanggil fungsi ini, COM harus diinisialisasi dengan memanggil CoInitialize atau CoInitializeEx.

Memanggil ImageList_CoCreateInstance untuk daftar gambar yang dikustomisasi; jika tidak, panggil SHGetImageList untuk memuat daftar gambar sistem. Panggil SHGetFileInfo dengan parameter uflag diatur ke SHGFI_SYSICONINDEX untuk mengambil handel ke daftar gambar sistem.

Persyaratan

Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	commoncontrols.h
Pustaka	Comctl32.lib
DLL	Comctl32.dll