INF Ini2Reg Direktive
Achtung
Ab Windows 11 Version 22H2 ist ein Treiberpaket, das diese Direktive verwendet, nicht mehr für eine Signatur vom Hardware Developer Center geeignet.
Universelle Treiberpakete und Windows-Treiber können diese Direktive nicht verwenden.
Eine Ini2Reg-Direktive verweist auf einen oder mehrere benannte Abschnitte, in denen Zeilen oder Abschnitte aus einer mitgelieferten INI-Datei in die Registrierung verschoben werden. Dies erstellt oder ersetzt einen oder mehrere Werteinträge unter einem bestimmten Schlüssel.
[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, der von einer Ini2Reg-Direktive referenziert wird, hat die folgende Form:
[ini-to-registry-section]
ini-file,ini-section,[ini-key],reg-root,subkey[,flags]
...
Ein ini-to-registry-section kann eine beliebige, vom/von der INF-Autor*in festgelegte Anzahl von Einträgen haben, jeder in einer eigenen Zeile.
Entries
ini-file
Gibt den Namen einer INI-Datei an, die sich auf dem Quellmedium befindet. Dieser Wert kann als filename oder als %strkey% Token ausgedrückt werden, das in einem Strings-Abschnitt der INF-Datei definiert ist.
ini-section
Gibt den Namen des Abschnitts innerhalb 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-section in die angegebene Registrierung subkey übertragen werden.
reg-root
Identifiziert die Root des Registrierungsbaums für andere in diesem Eintrag angegebene Werte. Weitere Informationen finden Sie in der Referenz für die Direktive AddReg.
subkey
Identifiziert den Unterschlüssel, der den Wert erhalten soll, entweder als %strkey% Token, das in einem Strings-Abschnitt der INF definiert ist oder als expliziter Registrierungspfad (key1\key2\key3...) von der angegebenen reg-root.
flags
Legt (in Bit 0) fest, wie die INI-Datei nach der Übertragung der angegebenen Informationen in die Registrierung behandelt werden soll und/oder (in Bit 1), ob vorhandene Registrierungsinformationen überschrieben werden sollen, wie folgt:
Bit null = 0
Entfernen Sie die angegebenen Informationen nicht aus der INI-Datei, nachdem Sie sie in die Registrierung kopiert haben. Dies ist die Standardeinstellung.
Bit null = 1
Lösche die angegebene Information aus der INI-Datei, nachdem Du sie in die Registrierung kopiert hast.
Bit eins = 0
Wenn der angegebene Unterschlüssel bereits in der Registrierung existiert, übertragen Sie die von der INI-Datei gelieferten Informationen nicht in diesen subkey. Andernfalls erstellen Sie den angegebenen subkey in der Registrierung mit dieser von der INI gelieferten Information als Werteintrag. Dies ist die Standardeinstellung.
Bit eins = 1
Wenn der angegebene Unterschlüssel bereits in der Registrierung vorhanden ist, ersetzen Sie seinen Werteintrag durch die von INI gelieferten Informationen.
Hinweise
Die Direktive Ini2Reg ist in jedem der Abschnitte gültig, die in der formalen Syntaxanweisung aufgeführt sind. Diese Direktive ist auch in von INF-Autoren*innen definierten Abschnitten gültig, auf die eine AddInterface-Direktive verweist oder die in einem InterfaceInstall32-Abschnitt referenziert werden.
Wenn eine INF-Datei zur Installation von Geräten unter Windows XP und späteren Versionen von Windows verwendet wird, sollte die INF-Datei keine Ini2Reg-Direktiven enthalten. INF-Dateien, die Ini2Reg-Direktiven enthalten, bestehen den „Designed For Windows“-Logo-Test nicht, erhalten keine digitale Signatur und werden daher von Windows nicht als vertrauenswürdig eingestuft (siehe Wie Windows Treiber auswählt).
Jeder ini-to-registry-section-Name muss in der INF-Datei eindeutig sein. Jeder von INF-Autor*innen erstellte Abschnittsname muss innerhalb der INF-Datei eindeutig sein und den allgemeinen Regeln für die Definition von Abschnittsnamen entsprechen. Weitere Informationen zu diesen Regeln finden Sie unter Allgemeine Syntaxregeln für INF-Dateien.
Die INF-Datei gibt den vollständigen Pfad der angegebenen ini-file auf dem Distributionsmedium auf eine der folgenden Arten an:
In von IHV/OEM gelieferten INF-Dateien können Sie in den Abschnitten SourceDisksNames und möglicherweise SourceDisksFiles dieser INF-Datei explizit den vollständigen Pfad jeder benannten Quelldatei angeben, die sich nicht im Root-Verzeichnis (oder den Verzeichnissen) auf dem Distributionsmedium 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 angegeben sind.