CM_Add_ID_ExA (cfgmgr32.h)

Artikel
08/22/2023

[Dimulai dengan Windows 8 dan Windows Server 2012, fungsi ini tidak digunakan lagi. 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_ExA(
  DEVINST  dnDevInst,
  PSTR     pszID,
  ULONG    ulFlags,
  HMACHINE hMachine
);

Parameter

dnDevInst

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

pszID

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

ulFlags

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

Bendera Konstanta	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.

hMachine

Handel mesin yang disediakan penelepon yang ditangani 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, kode kesalahan 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.

Penelepon 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