fungsi CM_Add_ID_ExW (cfgmgr32.h)

Artikel
02/23/2024

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

Fungsi CM_Add_ID_Ex menambahkan ID perangkat (jika belum ada) ke daftar ID perangkat keras instans perangkat atau daftar ID yang kompatibel , baik di komputer lokal atau jarak jauh.

Sintaks

CMAPI CONFIGRET CM_Add_ID_ExW(
  [in]           DEVINST  dnDevInst,
  [in]           PWSTR    pszID,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parameter

[in] dnDevInst

Handel instans perangkat yang disediakan penelepon yang terikat ke handel mesin yang disediakan oleh

hMachine

[in] pszID

Penunjuk yang disediakan penelepon ke string ID perangkat yang dihentikan NULL.

[in] ulFlags

Konstanta bendera yang disediakan penelepon yang menentukan daftar tempat ID perangkat yang disediakan harus ditambahkan. Konstanta bendera berikut valid.

Konstanta Bendera	Definisi
CM_ADD_ID_COMPATIBLE	ID perangkat yang ditentukan harus ditambahkan ke daftar ID yang kompatibel dengan instans perangkat tertentu.
CM_ADD_ID_HARDWARE	ID perangkat yang ditentukan harus ditambahkan ke daftar ID perangkat keras instans perangkat tertentu.

[in, optional] hMachine

Handel mesin yang disediakan penelepon di mana handel instans perangkat yang disediakan pemanggil terikat.

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, ia mengembalikan salah satu kode kesalahan awalan CR_ yang ditentukan dalam Cfgmgr32.h.

Keterangan

Setiap ID perangkat yang ditambahkan dianggap kurang kompatibel daripada ID yang sudah ada dalam daftar yang ditentukan. Untuk informasi tentang ID perangkat, ID perangkat keras, dan ID yang kompatibel, lihat String Identifikasi Perangkat.

Pemanggil fungsi ini harus memiliki SeLoadDriverPrivilege. (Hak istimewa dijelaskan dalam dokumentasi Microsoft Windows SDK.)

Untuk informasi tentang menggunakan handel instans perangkat yang terikat ke komputer lokal atau jarak jauh, lihat CM_Get_Child_Ex.

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_Add_ID

CM_Get_Child_Ex

Bagikan melalui