Fungsi SetupDiBuildClassInfoListExW (setupapi.h)

Artikel
08/26/2023

Fungsi SetupDiBuildClassInfoListEx mengembalikan daftar GUID kelas penyiapan yang mencakup setiap kelas yang diinstal pada sistem lokal atau sistem jarak jauh.

Sintaks

WINSETUPAPI BOOL SetupDiBuildClassInfoListExW(
  [in]            DWORD  Flags,
  [out, optional] LPGUID ClassGuidList,
  [in]            DWORD  ClassGuidListSize,
  [out]           PDWORD RequiredSize,
  [in, optional]  PCWSTR MachineName,
                  PVOID  Reserved
);

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 buffer yang menerima daftar GUID kelas penyiapan.

[in] ClassGuidListSize

Memasok jumlah GUID dalam array ClassGuildList .

[out] RequiredSize

Pointer ke variabel yang menerima jumlah GUID yang dikembalikan. Jika angka ini lebih besar dari ukuran ClassGuidList, angka menunjukkan seberapa besar array ClassGuidList harus berisi daftar.

[in, optional] MachineName

Penunjuk ke string yang dihentikan NULL yang berisi nama komputer jarak jauh untuk mengambil kelas penyiapan yang diinstal. Parameter ini bersifat opsional dan dapat berupa NULL. Jika MachineNameNULL, fungsi ini menyusun daftar kelas yang diinstal pada komputer 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, kesalahan mengembalikan FALSE dan kesalahan yang dicatat dapat diambil dengan melakukan panggilan ke GetLastError.

Keterangan

Catatan

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

SetupDiBuildClassInfoList

SetupDiGetClassDescriptionEx

Bagikan melalui