fungsi CM_Enumerate_Enumerators_ExA (cfgmgr32.h)

Artikel
03/08/2023

[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 nama setiap enumerator.

Sintaks

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

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.

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

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 atau jarak jauh, panggil CM_Enumerate_Enumerators_Ex 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.

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


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

Bagikan melalui