fungsi CM_Enumerate_Classes_Ex (cfgmgr32.h)

Artikel
03/08/2023

[Dimulai dengan Windows 8 dan Windows Server 2012, fungsi ini tidak digunakan lagi. Silakan gunakan CM_Enumerate_Classes sebagai gantinya.]

Fungsi CM_Enumerate_Classes_Ex , ketika dipanggil berulang kali, menghitung kelas perangkat yang diinstal komputer lokal atau jarak jauh, dengan memasok GUID setiap kelas.

Sintaks

CMAPI CONFIGRET CM_Enumerate_Classes_Ex(
  [in]           ULONG    ulClassIndex,
  [out]          LPGUID   ClassGuid,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parameter

[in] ulClassIndex

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

[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.

[in, optional] hMachine

Handel mesin yang disediakan penelepon, diperoleh dari panggilan sebelumnya ke CM_Connect_Machine.

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

Nilai kembali

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 atau jarak jauh, panggil CM_Enumerate_Classes_Ex berulang kali, dimulai dengan nilai indeks ulClassIndex nol dan menaikkan 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_Ex kembalikan. Sebelum Windows 8, CM_Enumerate_Classes_Ex hanya mengembalikan kelas penyiapan perangkat.

Fungsionalitas untuk mengakses komputer jarak jauh telah dihapus di Windows 8 dan Windows Server 2012 dan sistem operasi yang lebih baru sehingga Anda tidak dapat mengakses komputer jarak jauh saat berjalan pada versi Windows ini.

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

Bagikan melalui