fungsi CM_Open_DevNode_Key (cfgmgr32.h)

  • Artikel

Fungsi CM_Open_DevNode_Key membuka kunci registri untuk informasi konfigurasi khusus perangkat.

Sintaks

CMAPI CONFIGRET CM_Open_DevNode_Key(
  [in]  DEVINST        dnDevNode,
  [in]  REGSAM         samDesired,
  [in]  ULONG          ulHardwareProfile,
  [in]  REGDISPOSITION Disposition,
  [out] PHKEY          phkDevice,
  [in]  ULONG          ulFlags
);

Parameter

[in] dnDevNode

Handel instans perangkat yang disediakan penelepon yang terikat ke komputer lokal

[in] samDesired

Akses keamanan registri yang diperlukan untuk kunci yang diminta.

[in] ulHardwareProfile

Profil perangkat keras yang akan dibuka jika ulFlags menyertakan CM_REGISTRY_CONFIG. Jika nilai ini nol, kunci untuk profil perangkat keras saat ini dibuka.

[in] Disposition

Menentukan bagaimana kunci registri akan dibuka. Mungkin salah satu nilai berikut:

RegDisposition_OpenAlways

Buka kunci jika ada. Jika tidak, buat kunci.

RegDisposition_OpenExisting

Buka kunci hanya jika ada.

[out] phkDevice

Arahkan ke HKEY yang akan menerima kunci yang dibuka setelah berhasil.

[in] ulFlags

Buka bendera kunci simpul perangkat. Menunjukkan cakupan dan jenis kunci penyimpanan registri untuk dibuka. Dapat berupa kombinasi dari bendera berikut:

CM_REGISTRY_HARDWARE

Buka kunci perangkat keras perangkat. Jangan gabungkan dengan CM_REGISTRY_SOFTWARE.

CM_REGISTRY_SOFTWARE

Buka kunci perangkat lunak perangkat. Jangan gabungkan dengan CM_REGISTRY_HARDWARE.

CM_REGISTRY_USER

Buka kunci per pengguna untuk pengguna saat ini. Jangan gabungkan dengan CM_REGISTRY_CONFIG.

CM_REGISTRY_CONFIG

Buka kunci yang menyimpan informasi konfigurasi khusus profil perangkat keras. Jangan gabungkan dengan CM_REGISTRY_USER.

Menampilkan 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

Tutup handel yang dikembalikan dari fungsi ini dengan memanggil RegCloseKey.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru.
Target Platform Universal
Header cfgmgr32.h (termasuk Cfgmgr32.h)
Pustaka Cfgmgr32.lib; OneCoreUAP.lib di Windows 10
DLL CfgMgr32.dll

Lihat juga

CM_Delete_DevNode_Key

SetupDiOpenDevRegKey