fungsi CM_Open_Device_Interface_KeyW (cfgmgr32.h)
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_KeyW(
[in] LPCWSTR 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.
Nilai kembali
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 |