fungsi CM_Enumerate_Enumerators_ExW (cfgmgr32.h)

  • Artikel

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

Fungsi CM_Enumerate_Enumerators_Ex menghitung enumerator perangkat komputer lokal atau jarak jauh, dengan menyediakan setiap nama enumerator.

Sintaks

CMAPI CONFIGRET CM_Enumerate_Enumerators_ExW(
  [in]           ULONG    ulEnumIndex,
  [out]          PWSTR    Buffer,
  [in, out]      PULONG   pulLength,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

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.

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

Mengembalikan 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 atau jarak jauh, panggil CM_Enumerate_Enumerators_Ex berulang kali, dimulai dengan nilai indeks ulEnumIndex nol, dan menambah 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.

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

Lihat juga

CM_Enumerate_Enumerators