Fungsi SetupDiCreateDeviceInterfaceRegKeyA (setupapi.h)

Artikel
03/15/2023

Fungsi SetupDiCreateDeviceInterfaceRegKey membuat kunci registri untuk menyimpan informasi tentang antarmuka perangkat dan mengembalikan handel ke kunci.

Sintaks

WINSETUPAPI HKEY SetupDiCreateDeviceInterfaceRegKeyA(
  [in]           HDEVINFO                  DeviceInfoSet,
  [in]           PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
                 DWORD                     Reserved,
  [in]           REGSAM                    samDesired,
  [in, optional] HINF                      InfHandle,
  [in, optional] PCSTR                     InfSectionName
);

Parameter

[in] DeviceInfoSet

Handel ke kumpulan informasi perangkat yang berisi antarmuka untuk membuat kunci registri. Kumpulan informasi perangkat tidak boleh berisi elemen jarak jauh.

[in] DeviceInterfaceData

Penunjuk ke struktur SP_DEVICE_INTERFACE_DATA yang menentukan antarmuka perangkat di DeviceInfoSet. Pointer ini mungkin dikembalikan oleh SetupDiCreateDeviceInterface.

Reserved

Dicadangkan. Harus nol.

[in] samDesired

Akses keamanan registri yang diminta pemanggil untuk kunci yang sedang dibuat. Untuk informasi tentang nilai akses keamanan registri jenis REGSAM, lihat dokumentasi Microsoft Windows SDK.

[in, optional] InfHandle

Handel ke file INF terbuka yang berisi bagian DDInstall yang akan dijalankan untuk kunci yang baru dibuat. Parameter ini bersifat opsional dan dapat berupa NULL. Jika parameter ini bukan NULL, InfSectionName juga harus ditentukan.

[in, optional] InfSectionName

Penunjuk ke nama bagian INF DDInstall dalam file INF yang ditentukan oleh InfHandle. Bagian ini dijalankan untuk kunci yang baru dibuat. Parameter ini bersifat opsional dan dapat berupa NULL. Jika parameter ini ditentukan, InfHandle juga harus ditentukan.

Mengembalikan nilai

Jika SetupDiCreateDeviceInterfaceRegKey berhasil, fungsi mengembalikan handel ke kunci registri yang diminta di mana informasi antarmuka dapat disimpan dan diambil. Jika SetupDiCreateDeviceInterfaceRegKey gagal, fungsi mengembalikan INVALID_HANDLE_VALUE. Panggil GetLastError untuk mendapatkan informasi kesalahan yang diperluas.

Keterangan

Pemanggil fungsi ini harus menjadi anggota grup Administrator.

Jika kunci yang diminta untuk antarmuka perangkat sudah ada, SetupDiCreateDeviceInterfaceRegKey mengembalikan handel ke kunci tersebut; jika tidak, SetupDiCreateDeviceInterfaceRegKey membuat kunci registri nonvolatile baru untuk antarmuka perangkat yang ditentukan. Pemanggil fungsi ini dapat menyimpan data konfigurasi privat untuk antarmuka perangkat dalam kunci ini. Driver untuk perangkat dapat mengakses kunci ini menggunakan rutinitas IoXxx .

Tutup handel yang dikembalikan dari fungsi ini dengan memanggil RegCloseKey.

Untuk penginstalan yang menggunakan file tata letak (ditentukan oleh entri LayoutFile di bagian Versi INF), file tata letak harus dibuka dengan panggilan ke SetupOpenAppendInfFile (dijelaskan dalam dokumentasi Windows SDK) sebelum SetupDiCreateDeviceInterfaceRegKey dipanggil.

Set informasi perangkat yang ditentukan oleh DeviceInfoSet hanya boleh berisi elemen pada komputer lokal.

Catatan

Header setupapi.h mendefinisikan SetupDiCreateDeviceInterfaceRegKey sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor 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 2000 dan versi Windows yang lebih baru.
Target Platform	Desktop
Header	setupapi.h (termasuk Setupapi.h)
Pustaka	Setupapi.lib

Lihat juga

SetupDiCreateDeviceInterface

SetupDiDeleteDeviceInterfaceRegKey

SetupDiOpenDeviceInterfaceRegKey

Bagikan melalui