Fungsi SetupDiDeleteDevRegKey (setupapi.h)
Fungsi SetupDiDeleteDevRegKey menghapus kunci registri tertentu yang dapat diakses pengguna yang terkait dengan elemen informasi perangkat.
Sintaks
WINSETUPAPI BOOL SetupDiDeleteDevRegKey(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData,
[in] DWORD Scope,
[in] DWORD HwProfile,
[in] DWORD KeyType
);
Parameter
[in] DeviceInfoSet
Handel ke kumpulan informasi perangkat yang berisi elemen informasi perangkat yang mewakili perangkat untuk menghapus kunci registri. Kumpulan informasi perangkat tidak boleh berisi elemen jarak jauh.
[in] DeviceInfoData
Penunjuk ke struktur SP_DEVINFO_DATA yang menentukan elemen informasi perangkat di DeviceInfoSet.
[in] Scope
Cakupan kunci registri yang akan dihapus. Cakupan menunjukkan di mana informasi berada. Kuncinya bisa spesifik profil global atau perangkat keras. Dapat berupa salah satu dari nilai berikut:
DICS_FLAG_GLOBAL
Hapus kunci yang menyimpan informasi konfigurasi global.
DICS_FLAG_CONFIGSPECIFIC
Hapus kunci yang menyimpan informasi konfigurasi khusus profil perangkat keras.
[in] HwProfile
Jika Cakupan diatur ke DICS_FLAG_CONFIGSPECIFIC, parameter HwProfile menentukan profil perangkat keras untuk menghapus kunci registri. Jika HwProfile adalah 0, kunci untuk profil perangkat keras saat ini akan dihapus. Jika HwProfile 0xFFFFFFFF, kunci registri untuk semua profil perangkat keras akan dihapus.
[in] KeyType
Jenis kunci penyimpanan registri yang akan dihapus. Dapat berupa salah satu dari nilai berikut:
DIREG_DEV
Hapus kunci perangkat keras perangkat.
DIREG_DRV
Hapus kunci perangkat lunak perangkat.
DIREG_BOTH
Hapus kunci perangkat keras dan perangkat lunak untuk perangkat.
Nilai kembali
Fungsi mengembalikan TRUE jika berhasil. Jika tidak, ia mengembalikan FALSE dan kesalahan yang dicatat dapat diambil dengan panggilan ke GetLastError.
Keterangan
Pemanggil fungsi ini harus menjadi anggota grup Administrator.
DeviceInfoSet hanya boleh berisi elemen pada komputer lokal.
Persyaratan
| 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 |
| DLL | Setupapi.dll |