SetupDiGetClassImageListExA (setupapi.h)

Fungsi SetupDiGetClassImageListEx membangun daftar gambar bitmap untuk setiap kelas yang diinstal pada sistem lokal atau jarak jauh.

Sintaksis

WINSETUPAPI BOOL SetupDiGetClassImageListExA(
  [out]          PSP_CLASSIMAGELIST_DATA ClassImageListData,
  [in, optional] PCSTR                   MachineName,
                 PVOID                   Reserved
);

Parameter

[out] ClassImageListData

Penunjuk ke struktur SP_CLASSIMAGELIST_DATA untuk menerima informasi mengenai daftar gambar kelas, termasuk handel ke daftar gambar. Bidang cbSize struktur ini harus diinisialisasi dengan ukuran struktur, dalam byte, sebelum memanggil fungsi ini atau akan gagal.

[in, optional] MachineName

Penunjuk ke string yang dihentikan NULL yang menyediakan nama sistem jarak jauh yang kelasnya SetupDiGetClassImageListEx harus membangun bitmap. Parameter ini bersifat opsional dan dapat NULL. Jika MachineName null, SetupDiGetClassImageListEx membangun daftar untuk sistem lokal.

Hati

Menggunakan fungsi ini untuk mengakses komputer jarak jauh tidak didukung dimulai dengan Windows 8 dan Windows Server 2012, karena fungsionalitas ini telah dihapus.

Reserved

Harus null.

Mengembalikan nilai

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

Komentar

Daftar gambar yang dibangun oleh fungsi ini harus dihancurkan dengan memanggil SetupDiDestroyClassImageList.

Catat ikon khusus Kelas pada komputer jarak jauh hanya dapat ditampilkan jika kelas juga ada di komputer lokal. Dengan demikian, jika komputer jarak jauh memiliki kelas X, tetapi kelas X tidak diinstal secara lokal, ikon generik (tidak diketahui) akan dikembalikan.

 

Nota

Header setupapi.h mendefinisikan SetupDiGetClassImageListEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprocessor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

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

Lihat juga

SetupDiDestroyClassImageList

SetupDiGetClassImageList