Direktif INF DelReg

Artikel
06/15/2023

Perhatian

Jika Anda membangun paket Driver universal atau Windows, arahan ini tidak valid. Lihat Menggunakan File INF Universal dan Memulai Driver Windows.

Direktif DelReg mereferensikan satu atau beberapa bagian yang ditentukan penulis INF yang menjelaskan entri kunci dan/atau 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]
...

Del-registry-section 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 bisa menjadi salah satu dari yang 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.

Subkunci
Nilai opsional ini, dibentuk baik 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:

Subkuntang yang akan dihapus dari registri di akhir jalur registri yang diberikan
Subkunjud yang sudah ada dari mana nama-entri-nilai yang diberikan akan dihapus

value-entry-name
Nilai ini mengidentifikasi entri nilai bernama yang akan dihapus dari subkuncar 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, nilai-entry-name (jika ditentukan) atau subkunjud 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

Direktif DelReg dapat ditentukan di bawah salah satu bagian yang ditunjukkan dalam pernyataan sintaks formal di atas. Direktif ini juga dapat ditentukan di bawah salah satu bagian yang ditentukan penulis INF berikut:

Bagian service-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 subkuncar atau entri nilai dalam subkundang 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 yang basi 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