Direktif INF DelReg

Artikel
10/16/2024

Perhatian

Jika Anda membangun paket Universal atau Windows Driver, direktif ini tidak valid. Lihat Menggunakan File INF Universal dan Mulai mengembangkan driver Windows.

Direktif DelReg mereferensikan satu atau beberapa bagian yang ditentukan penulis INF yang menjelaskan kunci dan/atau entri nilai yang akan dihapus dari registri.

[DDInstall] | 
[DDInstall.CoInstallers] | 
[ClassInstall32] | 
[ClassInstall32.ntx86] | 
[ClassInstall32.ntia64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntamd64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntarm] | (Windows 8 and later versions of Windows)
[ClassInstall32.ntarm64] (Windows 10 version 1709 and later versions of Windows)
 
DelReg=del-registry-section[,del-registry-section]...

Setiap del-registry-section yang direferensikan oleh direktif DelReg memiliki formulir berikut:

[del-registry-section]
reg-root-string,subkey[,value-entry-name][,flags][,value]
reg-root-string,subkey[,value-entry-name][,flags][,value]
...

Bagian del-registry dapat memiliki sejumlah entri, masing-masing pada baris terpisah.

Entri

reg-root-string
Mengidentifikasi akar pohon registri untuk nilai lain yang disediakan dalam entri ini. Nilainya dapat berupa salah satu dari berikut ini:

HKCR
Singkatan untuk HKEY_CLASSES_ROOT.

HKCU
Singkatan untuk HKEY_CURRENT_USER.

HKLM
Singkatan untuk HKEY_LOCAL_MACHINE.

HKU
Singkatan untuk HKEY_USERS.

HKR
Akar relatif, di mana kunci yang ditentukan dengan menggunakan singkatan ini relatif terhadap kunci registri yang terkait dengan bagian INF tempat arahan DelReg ini muncul, seperti yang ditunjukkan dalam tabel berikut.

Bagian INF Berisi Direktif AddReg	Kunci Registri Yang Direferensikan oleh HKR
Bagian INF DDInstall	Kunci perangkat lunak perangkat
INF DDInstall. Bagian HW	Kunci perangkat keras perangkat
INF DDInstall. Bagian layanan	Kunci Layanan

Catatan

HKR tidak dapat digunakan dalam bagian del-registry yang direferensikan dari bagian INF DefaultInstall.

Untuk informasi selengkapnya tentang informasi driver yang disimpan di bawah akar HKEY_LOCAL_MACHINE , lihat Pohon registri dan Kunci untuk Perangkat dan Driver.

subkunjuk
Nilai opsional ini, dibentuk sebagai token %strkey% yang ditentukan di bagian String INF atau sebagai jalur registri di bawah reg-root yang diberikan (key1\key2\key3...), menentukan salah satu hal berikut:

Subkunjung yang akan dihapus dari registri di akhir jalur registri yang diberikan
Subkunjuk yang ada tempat nama-entri nilai yang diberikan akan dihapus

value-entry-name
Nilai ini mengidentifikasi entri nilai bernama yang akan dihapus dari subkuntang yang diberikan. Nilai ini dan koma sebelumnya harus dihilangkan jika subkunci itu sendiri dihapus dari registri.

bendera (Windows XP dan versi Windows yang lebih baru.)
Nilai heksadesimal opsional ini, dinyatakan sebagai bitmask ORed dari nilai bendera kata rendah dan kata tinggi yang ditentukan sistem, menentukan jenis data untuk entri nilai, atau mengontrol operasi delete-registry. Jika bendera tidak ditentukan, value-entry-name (jika ditentukan) atau subkundi akan dihapus.

Nilai bitmask untuk masing-masing bendera ini adalah sebagai berikut:

0x00002000 (FLG_DELREG_KEYONLY_COMMON)
Hapus seluruh subkunjuk.

0x00004000 (FLG_DELREG_32BITKEY)
Buat perubahan yang ditentukan dalam registri 32-bit. Jika tidak ditentukan, perubahan dilakukan pada registri asli.

0x00018002 (FLG_DELREG_MULTI_SZ_DELSTRING)
Dalam entri registri multistring, hapus semua string yang cocok dengan nilai string yang ditentukan oleh nilai. Kasus diabaikan.

nilai (Windows XP dan versi Windows yang lebih baru.)
Menentukan nilai registri, jika bendera menunjukkan bahwa nilai registri diperlukan.

Keterangan

Arahan DelReg dapat ditentukan di bawah salah satu bagian yang ditunjukkan dalam pernyataan sintaks formal di atas. Arahan ini juga dapat ditentukan di bawah salah satu bagian yang ditentukan inf-writer berikut:

Bagian layanan-install-section atau event-log-install yang direferensikan oleh direktif AddService dalam INF DDInstall. Bagian layanan.
Bagian add-interface yang direferensikan oleh direktif AddInterface dalam INF DDInstall. Bagian antarmuka.
Bagian antarmuka penginstalan yang dirujuk di bagian INF InterfaceInstall32.

Secara umum, INF tidak boleh mencoba menghapus subkuntang atau entri nilai dalam subkuntang yang ada yang disiapkan oleh komponen sistem atau oleh file INF untuk perangkat lain. Tujuan dari del-registry-section adalah untuk membersihkan informasi registri kedaluarsa dari penginstalan sebelumnya dengan menggunakan file INF baru yang disediakan oleh penyedia yang sama.

Setiap nama del-registry-section harus unik untuk file INF, tetapi dapat dirujuk oleh arahan DelReg di bagian lain dari INF yang sama. Setiap nama bagian harus mengikuti aturan umum untuk menentukan nama bagian. Untuk informasi selengkapnya tentang aturan ini, lihat Aturan Sintaks Umum untuk File INF.

Dengan versi sistem operasi sebelum Windows XP, satu-satunya cara untuk menghapus kunci adalah dengan menentukan hal berikut:

reg-root-string, subkey

Untuk Windows XP dan versi Windows yang lebih baru, berikut ini juga diizinkan (untuk menentukan registri 32-bit):

reg-root-string, subkey,,0x4000

Contoh

Contoh ini menunjukkan bagaimana INF penginstal kelas port COM/LPT yang disediakan sistem menghapus informasi registri khusus NT kedaluarsa tentang port COM dari registri.

[ComPort.NT]
AddReg=ComPort.NT.AddReg
 ... ; more directives omitted here

[ComPort.NT.HW]
DelReg=ComPort.NT.HW.DelReg

[Comport.NT.AddReg]
HKR,,EnumPropPages32,,"MSPorts.dll,SerialPortPropPageProvider"

[ComPort.NT.HW.DelReg]
HKR,,UpperFilters