INF DelReg-Direktive

Artikel
06/14/2023

Achtung

Wenn Sie ein universelles Oder Windows-Treiberpaket erstellen, ist diese Direktive ungültig. Weitere Informationen finden Sie unter Verwenden einer universellen INF-Datei und Erste Schritte mit Windows-Treibern.

Eine DelReg-Direktive verweist auf einen oder mehrere inF-writer-definierte Abschnitte, in denen Schlüssel und/oder Werteinträge beschrieben werden, die aus der Registrierung entfernt werden sollen.

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

Jeder del-registry-section , auf den durch eine DelReg-Direktive verwiesen wird, hat die folgende Form:

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

Ein del-registry-section kann eine beliebige Anzahl von Einträgen in einer separaten Zeile enthalten.

Einträge

reg-root-string
Gibt den Stamm der Registrierungsstruktur für andere Werte an, die in diesem Eintrag angegeben werden. Der Wert kann in folgenden Formen vorliegen:

HKCR
Abkürzung für HKEY_CLASSES_ROOT.

HKCU
Abkürzung für HKEY_CURRENT_USER.

HKLM
Abkürzung für HKEY_LOCAL_MACHINE.

HKU
Abkürzung für HKEY_USERS.

HKR
Relativer Stamm, in dem schlüssel, die mit dieser Abkürzung angegeben werden, relativ zum Registrierungsschlüssel, der dem INF-Abschnitt zugeordnet ist, in dem diese DelReg-Direktive angezeigt wird, wie in der folgenden Tabelle angegeben.

INF-Abschnitt, der die AddReg-Direktive enthält	Registrierungsschlüssel, auf den von HKR verwiesen wird
ABSCHNITT "INF DDInstall"	Der Softwareschlüssel des Geräts
INF DDInstall. Abschnitt "HW"	Der Hardwareschlüssel des Geräts
INF DDInstall. Abschnitt "Dienste "	Der Dienstschlüssel

Hinweis

HKR kann nicht in einem del-registry-abschnitt verwendet werden, auf den in einem INF DefaultInstall-Abschnitt verwiesen wird.

Weitere Informationen zu Treiberinformationen, die unter dem HKEY_LOCAL_MACHINE-Stamm gespeichert sind, finden Sie unter Registrierungsstrukturen und Schlüssel für Geräte und Treiber.

Unterschlüssel
Dieser optionale Wert, der entweder als %strkey%-Token gebildet wird, das in einem Strings-Abschnitt des INF definiert ist, oder als Registrierungspfad unter dem angegebenen reg-root (key1\key2\key3...), gibt eine der folgenden Werte an:

Ein Unterschlüssel, der am Ende des angegebenen Registrierungspfads aus der Registrierung gelöscht werden soll
Ein vorhandener Unterschlüssel, aus dem der angegebene Werteintragsname gelöscht werden soll.

value-entry-name
Dieser Wert identifiziert einen benannten Werteintrag, der aus dem angegebenen Unterschlüssel entfernt werden soll. Dieser Wert und sein vorangehendes Komma sollten weggelassen werden, wenn der Unterschlüssel selbst aus der Registrierung entfernt wird.

Flags (Windows XP und höhere Versionen von Windows.)
Dieser optionale Hexadezimalwert, ausgedrückt als ORed-Bitmaske von systemdefinierten Werten für niedrige Wörter und hohe Wortflagswerte, definiert den Datentyp für einen Werteintrag oder steuert den Delete-Registry-Vorgang. Wenn keine Flags angegeben sind, wird der Wert-Eintragsname (sofern angegeben) oder der Unterschlüssel gelöscht.

Bitmaskenwerte für jedes dieser Flags sind wie folgt:

0x00002000 (FLG_DELREG_KEYONLY_COMMON)
Löschen Sie den gesamten Unterschlüssel.

0x00004000 (FLG_DELREG_32BITKEY)
Nehmen Sie die angegebene Änderung in der 32-Bit-Registrierung vor. Wenn nicht angegeben, wird die Änderung an der nativen Registrierung vorgenommen.

0x00018002 (FLG_DELREG_MULTI_SZ_DELSTRING)
Löschen Sie innerhalb eines Registrierungseintrags mit mehreren Zeichenfolgen alle Zeichenfolgen, die einem durch wert angegebenen Zeichenfolgenwert entsprechen. Groß-/Kleinschreibung wird ignoriert.

value (Windows XP und höhere Versionen von Windows.)
Gibt einen Registrierungswert an, wenn Flags angibt, dass ein Registrierungswert erforderlich ist.

Hinweise

Eine DelReg-Direktive kann in jedem der Abschnitte angegeben werden, die in der obigen formalen Syntax-Anweisung gezeigt werden. Diese Direktive kann auch in einem der folgenden inF-writer-definierten Abschnitte angegeben werden:

Ein Abschnitt "service-install-section" oder "event-log-install ", auf den von der AddService-Direktive in einem INF DDInstall verwiesen wird. Abschnitt "Dienste".
Ein add-interface-section , auf den von der AddInterface-Direktive in einem INF DDInstall verwiesen wird. Abschnitt "Schnittstellen".
Ein abschnitt install-interface, auf den in einem INF InterfaceInstall32-Abschnitt verwiesen wird.

Im Allgemeinen sollte ein INF niemals versuchen, Unterschlüssel oder Werteinträge in vorhandenen Unterschlüsseln zu löschen, die von Systemkomponenten oder von den INF-Dateien für andere Geräte eingerichtet wurden. Der Zweck eines del-registry-section besteht darin, veraltete Registrierungsinformationen aus einer früheren Installation mithilfe einer neuen INF-Datei zu sauber, die vom gleichen Anbieter bereitgestellt wird.

Jeder Del-Registry-Abschnittsname muss für die INF-Datei eindeutig sein, aber er kann von DelReg-Anweisungen in anderen Abschnitten desselben INF referenziert werden. Jeder Abschnittsname muss den allgemeinen Regeln zum Definieren von Abschnittsnamen entsprechen. Weitere Informationen zu diesen Regeln finden Sie unter Allgemeine Syntaxregeln für INF-Dateien.

Bei Betriebssystemversionen vor Windows XP besteht die einzige Möglichkeit zum Löschen eines Schlüssels darin, Folgendes anzugeben:

reg-root-string, subkey

Für Windows XP und höhere Versionen von Windows ist auch Folgendes zulässig (um die 32-Bit-Registrierung anzugeben):

reg-root-string, subkey,,0x4000

Beispiele

Dieses Beispiel zeigt, wie der vom System bereitgestellte INF-Portierungs-Installer für COM/LPT-Ports veraltete NT-spezifische Registrierungsinformationen zu COM-Ports aus der Registrierung entfernt.

[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