INF Ini2Reg-Direktive

Artikel
07/20/2023

Achtung

Ab Windows 11 Version 22H2 ist ein Treiberpaket, das diese Direktive verwendet, nicht mehr für eine Signatur aus dem Hardware Developer Center berechtigt.

Universelle Treiberpakete und Windows-Treiber können diese Anweisung nicht verwenden.

Eine Ini2Reg-Direktive verweist auf einen oder mehrere benannte Abschnitte, in denen Zeilen oder Abschnitte aus einer bereitgestellten INI-Datei in die Registrierung verschoben werden. Dadurch wird ein oder mehrere Werteinträge unter einem angegebenen Schlüssel erstellt oder ersetzt.

[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)
  
Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...

Jeder benannte Abschnitt, auf den eine Ini2Reg-Direktive verweist, hat die folgende Form:

[ini-to-registry-section]
 
ini-file,ini-section,[ini-key],reg-root,subkey[,flags]
...

Ein Ini-to-Registry-Abschnitt kann eine beliebige vom INF-Writer bestimmte Anzahl von Einträgen in einer separaten Zeile aufweisen.

Einträge

ini-Datei
Gibt den Namen einer AUF dem Quellmedium bereitgestellten INI-Datei an. Dieser Wert kann als Dateiname oder als %strkey%-Token ausgedrückt werden, das in einem Strings-Abschnitt der INF-Datei definiert ist.

Ini-Abschnitt
Gibt den Namen des Abschnitts in der angegebenen INI-Datei an, der die zu kopierenden Registrierungsinformationen enthält.

ini-key
Gibt den Namen des Schlüssels in der INI-Datei an, der in die Registrierung kopiert werden soll. Wenn dieser Wert weggelassen wird, soll der gesamte ini-Abschnitt in den angegebenen Registrierungsunterschlüssel übertragen werden.

reg-root
Gibt den Stamm der Registrierungsstruktur für andere Werte an, die in diesem Eintrag angegeben werden. Einzelheiten finden Sie in der Referenz für die AddReg-Direktive.

Unterschlüssel
Gibt den Unterschlüssel an, der den Wert empfangen soll, ausgedrückt als %strkey%-Token, das in einem Strings-Abschnitt des INF definiert ist, oder als expliziter Registrierungspfad (key1\key2\key3...) aus dem angegebenen reg-root.

flags
Gibt (in Bit 0) an, wie die INI-Datei nach der Übertragung der angegebenen Informationen an die Registrierung und/oder (in Bit 1) wie folgt behandelt wird, ob vorhandene Registrierungsinformationen überschrieben werden sollen:

Bit null = 0
Entfernen Sie die angegebenen Informationen nicht aus der INI-Datei, nachdem Sie sie in die Registrierung kopiert haben. Dies ist die Standardoption.

Bit null = 1
Löschen Sie die angegebenen Informationen aus der INI-Datei, nachdem Sie sie in die Registrierung verschoben haben.

Bit 1 = 0
Wenn der angegebene Unterschlüssel bereits in der Registrierung vorhanden ist, übertragen Sie die von INI bereitgestellten Informationen nicht in diesen Unterschlüssel. Erstellen Sie andernfalls den angegebenen Unterschlüssel in der Registrierung mit diesen inI bereitgestellten Informationen als Werteintrag. Dies ist die Standardoption.

Bit 1 = 1
Wenn der angegebene Unterschlüssel bereits in der Registrierung vorhanden ist, ersetzen Sie dessen Werteintrag durch die von INI bereitgestellten Informationen.

Hinweise

Die Ini2Reg-Direktive ist in jedem der Abschnitte gültig, die in der formalen Syntax-Anweisung angezeigt werden. Diese Direktive ist auch in in INF-Writer-definierten Abschnitten gültig, auf die von einer AddInterface-Direktive verwiesen wird oder auf die in einem Abschnitt InterfaceInstall32 verwiesen wird.

Wenn eine INF-Datei zum Installieren von Geräten unter Windows XP und höheren Versionen von Windows verwendet wird, sollte die INF-Datei keine Ini2Reg-Anweisungen enthalten. INF-Dateien, die Ini2Reg-Direktiven enthalten, bestehen nicht die Logotests für "Für Windows entworfen", erhalten keine digitale Signatur und sind daher von Windows nicht vertrauenswürdig (siehe Wie Windows-Treiber auswählt).

Jeder Name des ini-to-registry-abschnitts muss für die INF-Datei eindeutig sein. Jeder vom INF-Writer erstellte Abschnittsname muss innerhalb der INF-Datei eindeutig sein und den allgemeinen Regeln zum Definieren von Abschnittsnamen entsprechen. Weitere Informationen zu diesen Regeln finden Sie unter Allgemeine Syntaxregeln für INF-Dateien.

Der INF stellt den vollständigen Pfad der angegebenen ini-Datei auf den Verteilungsmedien auf eine der folgenden Arten bereit:

In von IHV/OEM bereitgestellten INF-Dateien verwenden Sie die Abschnitte SourceDisksNames und möglicherweise SourceDisksFiles dieses INF, um den vollständigen Pfad jeder benannten Quelldatei explizit anzugeben, die sich nicht im Stammverzeichnis (oder den Verzeichnissen) auf den Verteilungsmedien befindet.
In vom System bereitgestellten INF-Dateien, indem Sie eine oder mehrere zusätzliche INF-Dateien bereitstellen, die im Eintrag LayoutFile im Abschnitt Version der INF-Datei identifiziert werden.