Fungsi SetupDiBuildClassInfoList (setupapi.h)

Artikel
03/15/2023

Fungsi SetupDiBuildClassInfoList mengembalikan daftar GUID kelas penyiapan yang mengidentifikasi kelas yang diinstal di komputer lokal.

Sintaks

WINSETUPAPI BOOL SetupDiBuildClassInfoList(
  [in]            DWORD  Flags,
  [out, optional] LPGUID ClassGuidList,
  [in]            DWORD  ClassGuidListSize,
  [out]           PDWORD RequiredSize
);

Parameter

[in] Flags

Bendera yang digunakan untuk mengontrol pengecualian kelas dari daftar. Jika tidak ada bendera yang ditentukan, semua kelas penyiapan disertakan dalam daftar. Bisa berupa kombinasi dari nilai berikut:

DIBCI_NOINSTALLCLASS

Kecualikan kelas jika memiliki entri nilai NoInstallClass dalam kunci registrinya.

DIBCI_NODISPLAYCLASS

Kecualikan kelas jika memiliki entri nilai NoDisplayClass dalam kunci registrinya.

[out, optional] ClassGuidList

Penunjuk ke array berjenis GUID yang menerima daftar GUID kelas penyiapan. Penunjuk ini bersifat opsional dan dapat berupa NULL.

[in] ClassGuidListSize

Jumlah GUID dalam array yang ditujukkan oleh parameter ClassGuildList . Jika ClassGuidListNULL, ClassGuidSize harus nol.

[out] RequiredSize

Penunjuk ke variabel berjenis DWORD yang menerima jumlah GUID yang dikembalikan (jika angkanya kurang dari atau sama dengan ukuran, dalam GUID, dari array yang ditujukkan oleh parameter ClassGuidList ).

Jika angka ini lebih besar dari ukuran array ClassGuidList , itu menunjukkan seberapa besar array ClassGuidList harus berisi semua GUID kelas.

Nilai kembali

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

Keterangan

Untuk mengambil jumlah kelas yang diinstal di komputer lokal, panggil SetupDiBuildClassInfoList dengan ClassGuidList yang diatur ke NULL dan ClassGuidSize diatur ke nol. Menanggapi panggilan seperti itu, fungsi mengembalikan jumlah kelas di *RequiredSize.

SetupDiBuildClassInfoList tidak mengembalikan GUID kelas untuk kelas jika entri nilai NoUseClass ada di kunci registri kelas.

Untuk mengambil daftar GUID kelas penyiapan yang diinstal pada sistem jarak jauh, gunakan SetupDiBuildClassInfoListEx.

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
DLL	Setupapi.dll

Lihat juga

SetupDiBuildClassInfoListEx

SetupDiGetClassDescription

SetupDiGetINFClass

Bagikan melalui