fungsi CM_Enumerate_EnumeratorsA (cfgmgr32.h)
Fungsi CM_Enumerate_Enumerators menghitung enumerator perangkat komputer lokal dengan menyediakan setiap nama enumerator.
Sintaks
CMAPI CONFIGRET CM_Enumerate_EnumeratorsA(
[in] ULONG ulEnumIndex,
[out] PSTR Buffer,
[in, out] PULONG pulLength,
[in] ULONG ulFlags
);
Parameter
[in] ulEnumIndex
Indeks yang disediakan penelepon ke dalam daftar enumerator perangkat mesin. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
[out] Buffer
Alamat buffer untuk menerima nama enumerator. Buffer ini harus berukuran MAX_DEVICE_ID_LEN (atau, atur Buffer ke nol dan dapatkan panjang nama aktual di lokasi yang dirujuk oleh puLength).
[in, out] pulLength
Alamat lokasi yang disediakan penelepon untuk menahan ukuran buffer. Pemanggil memasok panjang buffer yang ditujukkan oleh Buffer. Fungsi menggantikan nilai ini dengan ukuran aktual string nama enumerator. Jika panjang buffer yang disediakan penelepon terlalu kecil, fungsi ini memasok ukuran buffer yang diperlukan dan mengembalikan CR_BUFFER_SMALL.
[in] ulFlags
Tidak digunakan, harus nol.
Menampilkan nilai
Jika operasi berhasil, fungsi akan mengembalikan CR_SUCCESS. Jika tidak, kode kesalahan mengembalikan salah satu kode kesalahan awalan CR_ yang ditentukan dalam Cfgmgr32.h.
Keterangan
Untuk menghitung enumerator perangkat komputer lokal, panggil CM_Enumerate_Enumerators berulang kali, dimulai dengan nilai indeks ulEnumIndex nol. dan menaikkan nilai indeks dengan setiap panggilan berikutnya hingga fungsi mengembalikan CR_NO_SUCH_VALUE.
Setelah nama enumerator diperoleh, nama-nama tersebut dapat digunakan sebagai input untuk CM_Get_Device_ID_List.
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 |