fungsi CM_Open_Device_Interface_KeyA (cfgmgr32.h)

  • Artikel

Fungsi CM_Open_Device_Interface_Key membuka subkuntang registri yang digunakan oleh aplikasi dan driver untuk menyimpan informasi yang khusus untuk antarmuka perangkat.

Sintaks

CMAPI CONFIGRET CM_Open_Device_Interface_KeyA(
  [in]  LPCSTR         pszDeviceInterface,
  [in]  REGSAM         samDesired,
  [in]  REGDISPOSITION Disposition,
  [out] PHKEY          phkDeviceInterface,
  [in]  ULONG          ulFlags
);

Parameter

[in] pszDeviceInterface

Penunjuk ke string yang mengidentifikasi instans antarmuka perangkat untuk membuka subkunci registri.

[in] samDesired

Akses keamanan registri yang diminta ke subkuntang registri.

[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] phkDeviceInterface

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

[in] ulFlags

Dicadangkan. Harus diatur ke nol.

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

Tutup handel yang dikembalikan dari fungsi ini dengan memanggil RegCloseKey.

Catatan

Header cfgmgr32.h mendefinisikan CM_Open_Device_Interface_Key sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Microsoft Windows Vista dan versi Windows yang lebih baru.
Target Platform Universal
Header cfgmgr32.h (termasuk Cfgmgr32.h)
Pustaka Cfgmgr32.lib

Lihat juga

SetupDiOpenDeviceInterfaceRegKey