fungsi CM_Enumerate_Classes (cfgmgr32.h)

  • Artikel

Fungsi CM_Enumerate_Classes , ketika dipanggil berulang kali, menghitung kelas perangkat yang diinstal komputer lokal dengan memasok GUID setiap kelas.

Sintaks

CMAPI CONFIGRET CM_Enumerate_Classes(
  [in]  ULONG  ulClassIndex,
  [out] LPGUID ClassGuid,
  [in]  ULONG  ulFlags
);

Parameter

[in] ulClassIndex

Indeks yang disediakan penelepon ke dalam daftar kelas perangkat komputer. Untuk informasi selengkapnya, lihat bagian Keterangan.

[out] ClassGuid

Alamat yang disediakan penelepon dari struktur GUID (dijelaskan dalam Microsoft Windows SDK) untuk menerima GUID kelas perangkat.

[in] ulFlags

Dimulai dengan Windows 8, penelepon dapat menentukan bendera berikut:

CM_ENUMERATE_CLASSES_INSTALLER

Menghitung kelas penyiapan perangkat.

CM_ENUMERATE_CLASSES_INTERFACE

Menghitung kelas antarmuka perangkat.

Jika tidak, harus diatur ke nol.

Menampilkan nilai

Jika operasi berhasil, fungsi akan mengembalikan CR_SUCCESS. Jika tidak, ia mengembalikan salah satu kode kesalahan awalan CR_ yang ditentukan dalam Cfgmgr32.h.

Keterangan

Untuk menghitung kelas perangkat komputer lokal, panggil CM_Enumerate_Classes berulang kali, dimulai dengan nilai ulClassIndex nol dan tahapan nilai indeks dengan setiap panggilan berikutnya hingga fungsi mengembalikan CR_NO_SUCH_VALUE. Beberapa nilai indeks mungkin mewakili entri daftar yang berisi data kelas yang tidak valid, dalam hal ini fungsi mengembalikan CR_INVALID_DATA. Nilai yang dikembalikan ini dapat diabaikan.

GUID kelas yang diperoleh dari fungsi ini dapat digunakan sebagai input ke fungsi penginstalan perangkat.

Dimulai dengan sistem operasi Windows 8 dan yang lebih baru, penelepon dapat menggunakan anggota ulFlags untuk menentukan kelas perangkat mana yang harus CM_Enumerate_Classes kembalikan. Sebelum Windows 8, CM_Enumerate_Classes hanya mengembalikan kelas penyiapan perangkat.

Persyaratan

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

Lihat juga

CM_Enumerate_Classes_Ex