CM_Open_Device_Interface_Key_ExW (cfgmgr32.h)

  • Artikel

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

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

Sintaks

CMAPI CONFIGRET CM_Open_Device_Interface_Key_ExW(
  [in]           LPCWSTR        pszDeviceInterface,
  [in]           REGSAM         samDesired,
  [in]           REGDISPOSITION Disposition,
  [out]          PHKEY          phkDeviceInterface,
  [in]           ULONG          ulFlags,
  [in, optional] HMACHINE       hMachine
);

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.

[in, optional] hMachine

Handel mesin yang disediakan penelepon, diperoleh dari panggilan sebelumnya ke CM_Connect_Machine.

Catatan Menggunakan fungsi ini untuk mengakses komputer jarak jauh tidak didukung dimulai dengan Windows 8 dan Windows Server 2012, karena fungsi ini telah dihapus.
 

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_Ex 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 10 dan versi Windows yang lebih baru.
Target Platform Desktop
Header cfgmgr32.h (termasuk Cfgmgr32.h)
Pustaka Cfgmgr32.lib

Lihat juga

CM_Connect_Machine

SetupDiOpenDeviceInterfaceRegKey