Fungsi SetupDiLoadClassIcon (setupapi.h)

  • Artikel

Fungsi SetupDiLoadClassIcon memuat ikon besar dan mini untuk kelas yang ditentukan.

Sintaks

WINSETUPAPI BOOL SetupDiLoadClassIcon(
  [in]            const GUID *ClassGuid,
  [out, optional] HICON      *LargeIcon,
  [out, optional] PINT       MiniIconIndex
);

Parameter

[in] ClassGuid

Penunjuk ke GUID kelas tempat ikon harus dimuat.

[out, optional] LargeIcon

Penunjuk ke handel ikon yang menerima nilai handel untuk ikon besar yang dimuat untuk kelas yang ditentukan. Penunjuk ini bersifat opsional dan dapat berupa NULL. Jika penunjuk NULL, ikon besar tidak dimuat.

[out, optional] MiniIconIndex

Penunjuk ke variabel yang diketik INT yang menerima indeks ikon mini untuk kelas yang ditentukan. Ikon mini disimpan di cache ikon mini alat penginstal perangkat. Penunjuk bersifat opsional dan dapat berupa NULL.

Menampilkan nilai

Fungsi mengembalikan TRUE jika berhasil. Jika tidak, kesalahan mengembalikan FALSE dan kesalahan yang dicatat dapat diambil dengan panggilan ke GetLastError.

Keterangan

Ikon kelas telah ditentukan dan dimuat dari cache internal alat penginstal perangkat, atau dimuat langsung dari executable penginstal kelas. Fungsi ini mengkueri nilai registri ICON di bagian kelas yang ditentukan. Jika nilai ICON ditentukan, itu menunjukkan ikon mini mana yang akan dimuat.

Jika nilai ICON negatif, nilai absolut mewakili ikon yang telah ditentukan sebelumnya di registri kelas. Lihat SetupDiDrawMiniIcon untuk daftar ikon mini yang telah ditentukan sebelumnya.

Jika nilai ICON positif, nilai tersebut mewakili ikon dalam gambar executable penginstal kelas yang akan diekstraksi. Nilai 1 dicadangkan. Fungsi ini juga menggunakan nilai registri INSTALLER32 dan kemudian nilai registri ENUMPROPPAGES32 untuk menentukan gambar mana yang dapat dieksekusi untuk mengekstrak ikon. Untuk informasi selengkapnya tentang nilai registri ini, lihat Bagian INF ClassInstall32.

Ketika penelepon selesai menggunakan ikon , pemanggil harus memanggil DestroyIcon (yang dijelaskan dalam dokumentasi Microsoft Windows SDK).

Jika parameter LargeIcon ditentukan, tetapi parameter ClassGuid tidak menyediakan GUID kelas yang valid atau nilai registri Ikon kelas tidak valid, SetupDiLoadClassIcon memuat ikon besar default, mengembalikan handel untuk ikon besar, dan, jika parameter MiniIconIndex ditentukan, mengembalikan indeks ikon mini default.

Persyaratan

   
Klien minimum yang didukung Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru.
Target Platform Desktop
Header setupapi.h (termasuk Setupapi.h)
Pustaka Setupapi.lib
DLL Setupapi.dll

Lihat juga

SetupDiDrawMiniIcon

SetupDiGetClassBitmapIndex