Directive Inf DelReg

Article
06/15/2023

Attention

Si vous créez un package universel ou Windows Driver, cette directive n’est pas valide. Consultez Utilisation d’un fichier INF universel et Prise en main avec des pilotes Windows.

Une directive DelReg fait référence à une ou plusieurs sections définies par un enregistreur INF décrivant des clés et/ou des entrées de valeur à supprimer du Registre.

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

Chaque section del-registry référencée par une directive DelReg a la forme suivante :

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

Une del-registry-section peut avoir n’importe quel nombre d’entrées, chacune sur une ligne distincte.

Entrées

reg-root-string
Identifie la racine de l’arborescence du Registre pour les autres valeurs fournies dans cette entrée. Il peut s'agir de l'une des valeurs suivantes :

HKCR
Abréviation de HKEY_CLASSES_ROOT.

HKCU
Abréviation de HKEY_CURRENT_USER.

HKLM
Abréviation de HKEY_LOCAL_MACHINE.

HKU
Abréviation de HKEY_USERS.

HKR
Racine relative, dans laquelle les clés spécifiées à l’aide de cette abréviation sont relatives à la clé de Registre associée à la section INF dans laquelle cette directive DelReg apparaît, comme indiqué dans le tableau suivant.

Section INF contenant la directive AddReg	Clé de Registre référencée par HKR
Section INF DDInstall	Clé logicielle de l’appareil
INF DDInstall. Section HW	Clé matérielle de l’appareil
INF DDInstall. Section Services	Clé Services

Notes

HKR ne peut pas être utilisé dans une section del-registry-section référencée à partir d’une section INF DefaultInstall.

Pour plus d’informations sur les pilotes stockées sous la racine HKEY_LOCAL_MACHINE , consultez Arborescences et clés du Registre pour les périphériques et les pilotes.

Sous-clé
Cette valeur facultative, formée soit sous la forme d’un jeton %strkey% défini dans une section Strings de l’INF, soit sous la forme d’un chemin d’accès de Registre sous la racine reg donnée (key1\key2\key3...), spécifie l’un des éléments suivants :

Sous-clé à supprimer du Registre à la fin du chemin du Registre donné
Sous-clé existante à partir de laquelle la valeur-entry-name donnée doit être supprimée

value-entry-name
Cette valeur identifie une entrée de valeur nommée à supprimer de la sous-clé donnée. Cette valeur et la virgule précédente doivent être omises si la sous-clé elle-même est supprimée du Registre.

indicateurs (Windows XP et versions ultérieures de Windows.)
Cette valeur hexadécimale facultative, exprimée en tant que masque de bits ORed de valeurs d’indicateur de mot faible et de mot élevé définies par le système, définit le type de données d’une entrée de valeur ou contrôle l’opération delete-registry. Si les indicateurs ne sont pas spécifiés, la valeur-entry-name (si spécifiée) ou la sous-clé sont supprimées.

Les valeurs de masque de bits pour chacun de ces indicateurs sont les suivantes :

0x00002000 (FLG_DELREG_KEYONLY_COMMON)
Supprimez la sous-clé entière.

0x00004000 (FLG_DELREG_32BITKEY)
Apportez la modification spécifiée dans le Registre 32 bits. Si elle n’est pas spécifiée, la modification est apportée au Registre natif.

0x00018002 (FLG_DELREG_MULTI_SZ_DELSTRING)
Dans une entrée de Registre multistring, supprimez toutes les chaînes correspondant à une valeur de chaîne spécifiée par valeur. La casse est ignorée.

value (Windows XP et versions ultérieures de Windows.)
Spécifie une valeur de Registre, si les indicateurs indiquent qu’une valeur de Registre est requise.

Remarques

Une directive DelReg peut être spécifiée sous l’une des sections indiquées dans l’instruction de syntaxe formelle ci-dessus. Cette directive peut également être spécifiée dans l’une des sections suivantes définies par l’enregistreur INF :

Section d’installation de service ou event-log-install référencée par la directive AddService dans un DDInstall INF. Section Services.
Section d’interface supplémentaire référencée par la directive AddInterface dans un DDInstall INF. Section Interfaces.
Section install-interface référencée dans une section INF InterfaceInstall32.

En général, un INF ne doit jamais tenter de supprimer des sous-clés ou des entrées de valeur dans des sous-clés existantes qui ont été configurées par les composants système ou par les fichiers INF pour d’autres appareils. L’objectif d’une section del-registry est de propre informations de registre obsolètes d’une installation précédente à l’aide d’un nouveau fichier INF fourni par le même fournisseur.

Chaque nom del-registry-section doit être unique au fichier INF, mais il peut être référencé par des directives DelReg dans d’autres sections du même INF. Chaque nom de section doit suivre les règles générales de définition des noms de section. Pour plus d’informations sur ces règles, consultez Règles de syntaxe générales pour les fichiers INF.

Avec les versions de système d’exploitation antérieures à Windows XP, la seule façon de supprimer une clé consiste à spécifier les éléments suivants :

reg-root-string, subkey

Pour Windows XP et les versions ultérieures de Windows, les éléments suivants sont également autorisés (pour spécifier le Registre 32 bits) :

reg-root-string, subkey,,0x4000

Exemples

Cet exemple montre comment le programme d’installation INF du programme d’installation de la classe de ports COM/LPT fourni par le système supprime des informations de Registre obsolètes spécifiques à NT sur les ports COM du Registre.

[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