Fungsi SetupDiGetClassImageListExA (setupapi.h)

Artikel
03/04/2024

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

Sintaks

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 dari 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 berupa NULL. Jika MachineNameNULL, SetupDiGetClassImageListEx membuat daftar untuk sistem lokal.

Perhatian

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

Reserved

Harus NULL.

Mengembalikan nilai

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

Keterangan

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

Catatan 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, maka ikon generik (tidak diketahui) akan dikembalikan.

Catatan

Header setupapi.h mendefinisikan SetupDiGetClassImageListEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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

Persyaratan	Nilai
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

Lihat juga

SetupDiDestroyClassImageList

SetupDiGetClassImageList

Bagikan melalui