Direttiva INF DelReg

Articolo
02/02/2024

Attenzione

Se si sta creando un pacchetto universale o driver di Windows, questa direttiva non è valida. Vedere Uso di un file INF universale e Introduzione con i driver di Windows.

Una direttiva DelReg fa riferimento a una o più sezioni definite dal writer INF che descrivono le chiavi e/o le voci di valore da rimuovere dal Registro di sistema.

[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]...

Ogni sezione del registry a cui fa riferimento una direttiva DelReg ha il formato seguente:

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

Una sezione del registry può avere un numero qualsiasi di voci, ognuna in una riga separata.

Voci

reg-root-string
Identifica la radice dell'albero del Registro di sistema per altri valori forniti in questa voce. I possibili valori sono i seguenti:

HKCR
Abbreviazione di HKEY_CLASSES_ROOT.

HKCU
Abbreviazione di HKEY_CURRENT_USER.

HKLM
Abbreviazione di HKEY_LOCAL_MACHINE.

HKU
Abbreviazione di HKEY_USERS.

HKR
Radice relativa, in cui le chiavi specificate tramite questa abbreviazione sono relative alla chiave del Registro di sistema associata alla sezione INF in cui viene visualizzata questa direttiva DelReg , come indicato nella tabella seguente.

Sezione INF contenente la direttiva AddReg	Chiave del Registro di sistema a cui fa riferimento HKR
Sezione INF DDInstall	Chiave software del dispositivo
INF DDInstall. Sezione HW	Chiave hardware del dispositivo
INF DDInstall. Sezione Servizi	Chiave di Servizi

Nota

HKR non può essere usato in una sezione del registry a cui fa riferimento una sezione INF DefaultInstall.

Per altre informazioni sui driver archiviati nella radice HKEY_LOCAL_MACHINE , vedere Alberi e chiavi del Registro di sistema per dispositivi e driver.

Sottochiave
Questo valore facoltativo, formato come token %strkey% definito in una sezione Stringhe dell'INF o come percorso del Registro di sistema nella radice reg specificata (key1\key2\key3...), specifica uno dei seguenti:

Una sottochiave da eliminare dal Registro di sistema alla fine del percorso del Registro di sistema specificato
Sottochiave esistente da cui eliminare il valore-entry-name specificato

value-entry-name
Questo valore identifica una voce di valore denominata da rimuovere dalla sottochiave specificata. Questo valore e la virgola precedente devono essere omessi se la sottochiave stessa viene rimossa dal Registro di sistema.

flag (Windows XP e versioni successive di Windows).
Questo valore esadecimale facoltativo, espresso come maschera di bit ORed di valori di parola bassa definiti dal sistema e di flag di parole elevate, definisce il tipo di dati per una voce di valore o controlla l'operazione delete-registry. Se i flag non vengono specificati, verrà eliminata la sottochiavevalue-entry-name (se specificata) o .

I valori di maschera di bit per ognuno di questi flag sono i seguenti:

0x00002000 (FLG_DELREG_KEYONLY_COMMON)
Eliminare l'intera sottochiave.

0x00004000 (FLG_DELREG_32BITKEY )
Apportare la modifica specificata nel Registro di sistema a 32 bit. Se non specificato, la modifica viene apportata al Registro di sistema nativo.

0x00018002 (FLG_DELREG_MULTI_SZ_DELSTRING )
All'interno di una voce del Registro di sistema a più stringhe eliminare tutte le stringhe corrispondenti a un valore stringa specificato per value. Non viene fatta distinzione tra maiuscole e minuscole.

value (Windows XP e versioni successive di Windows).)
Specifica un valore del Registro di sistema, se i flag indicano che è necessario un valore del Registro di sistema.

Commenti

È possibile specificare una direttiva DelReg in una delle sezioni illustrate nell'istruzione di sintassi formale precedente. Questa direttiva può essere specificata anche in una delle sezioni INF-writer-defined seguenti:

Una sezione service-install-section o event-log-install a cui fa riferimento la direttiva AddService in un inF DDInstall. Sezione Servizi.
Sezione add-interface a cui fa riferimento la direttiva AddInterface in un inF DDInstall. Sezione Interfacce.
Sezione install-interface a cui si fa riferimento in una sezione INF InterfaceInstall32.

In generale, un INF non deve mai tentare di eliminare sottochiavi o voci di valore all'interno di sottochiavi esistenti configurate dai componenti di sistema o dai file INF per altri dispositivi. Lo scopo di una sezione del registry è pulire le informazioni non aggiornate del Registro di sistema da un'installazione precedente usando un nuovo file INF fornito dallo stesso provider.

Ogni nome della sezione del registry deve essere univoco per il file INF, ma può essere fatto riferimento dalle direttive DelReg in altre sezioni dello stesso INF. Ogni nome di sezione deve seguire le regole generali per la definizione dei nomi di sezione. Per altre informazioni su queste regole, vedere Regole di sintassi generali per i file INF.

Con le versioni del sistema operativo precedenti a Windows XP, l'unico modo per eliminare una chiave è specificando quanto segue:

reg-root-string, subkey

Per Windows XP e versioni successive di Windows, è anche consentito specificare il Registro di sistema a 32 bit:

reg-root-string, subkey,,0x4000

Esempio

In questo esempio viene illustrato in che modo l'INF del programma di installazione delle porte COM/LPT fornito dal sistema rimuove le informazioni sul Registro di sistema specifiche di NT non aggiornate sulle porte COM dal Registro di sistema.

[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