fungsi CM_Enumerate_Classes (cfgmgr32.h)
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 |