fungsi CM_Enumerate_EnumeratorsW (cfgmgr32.h)

  • Artikel

Fungsi CM_Enumerate_Enumerators menghitung enumerator perangkat komputer lokal dengan memasok nama setiap enumerator.

Sintaks

CMAPI CONFIGRET CM_Enumerate_EnumeratorsW(
  [in]      ULONG  ulEnumIndex,
  [out]     PWSTR  Buffer,
  [in, out] PULONG pulLength,
  [in]      ULONG  ulFlags
);

Parameter

[in] ulEnumIndex

Indeks yang disediakan penelepon ke dalam daftar enumerator perangkat komputer. 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 diacu oleh Buffer. Fungsi menggantikan nilai ini dengan ukuran sebenarnya dari string nama enumerator. Jika panjang buffer yang disediakan penelepon terlalu kecil, fungsi 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, ia 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

Lihat juga

CM_Enumerate_Enumerators_Ex