INF UpdateIniFields 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 Direktive UpdateIniFields verweist auf einen oder mehrere benannte Abschnitte, in denen detaillierte Änderungen innerhalb der Zeilen einer INI-Datei angegeben werden können.
[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)
UpdateIniFields=update-inifields-section[,update-inifields-section]...
Jeder benannte Abschnitt, der von einer UpdateIniFields-Direktive referenziert wird, hat die folgende Form:
[update-inifields-section]
ini-file,ini-section,profile-name[,old-field][,new-field][,flags]
...
Ein update-inifields-section kann eine beliebige, von INF-Autor*innen festgelegte Anzahl von Einträgen enthalten, die jeweils in einer eigenen Zeile stehen.
Entries
ini-file
Gibt den Namen einer INI-Datei an, die auf dem Quellmedium bereitgestellt wird, und implizit auch den einer zu aktualisierenden INI-Datei auf dem Zielcomputer. 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-Dateien an, der die zu ändernde Zeile enthält.
profile-name
Gibt den Namen der zu ändernden Zeile innerhalb des angegebenen INI-Abschnitts an. Mindestens einer der Einträge old-field und/oder new-field muss angegeben werden, um eine Änderung dieser Zeile zu bewirken.
old-field
Gibt ein bestehendes Feld innerhalb der angegebenen Zeile an. Wenn new-field in diesem Abschnittseintrag weggelassen wird, wird dieses Feld in der angegebenen Zeile gelöscht. Andernfalls soll der angegebene Wert new-field dieses Feld ersetzen.
new-field
Gibt einen Ersatz für ein gegebenes old-field an oder, wenn old-field ausgelassen wird, einen Zusatz zu der gegebenen Zeile.
flags
Gibt (in Bit 0) an, wie ein gegebenes old-field und/oder new-field zu interpretieren ist, wenn eines oder beide ein Sternchen (*) enthalten, und/oder (in Bit 1) welches Trennzeichen zu verwenden ist, wenn ein gegebenes new-field an die gegebene Zeile angehängt wird, wie folgt:
Bit null = 0
Interpretieren Sie jedes Sternchen (*) in den angegebenen old-field- und/oder new-field-Einträgen wörtlich, nicht als Wildcard-Zeichen, wenn Sie nach einer Übereinstimmung in der angegebenen Zeile der INI-Datei suchen. Dies ist der Standardwert.
Bit null = 1
Interpretieren Sie jedes Sternchen (*) in den angegebenen old-field- und/oder new-field-Einträgen als Wildcard-Zeichen, wenn Sie nach einer Übereinstimmung in der angegebenen Zeile der INI-Datei suchen.
Bit eins = 0
Verwenden Sie ein Leerzeichen als Trennzeichen, wenn Sie den angegebenen new-field-Eintrag in die angegebene Zeile der INI-Datei einfügen. Dies ist der Standardwert.
Bit eins = 1
Verwenden Sie ein Komma (,) als Trennzeichen, wenn Sie den angegebenen new-field-Eintrag in die angegebene Zeile der INI-Datei einfügen.
Hinweise
Die Direktive UpdateIniFields wird in INF-Dateien für Installationen unter Windows fast nie angegeben, da es nicht notwendig ist, INI-Dateien auf den Distributionsmedien zu haben. Die Direktive UpdateIniFields ist jedoch in allen Abschnitten gültig, die in der formalen Syntaxanweisung aufgeführt sind, sowie in von INF-Autoren*innen definierten Abschnitten, die von einer AddInterface-Direktive referenziert werden oder in einem InterfaceInstall32-Abschnitt referenziert werden.
Jeder update-inifields-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.
Im Gegensatz zu einem Abschnitt, der von der Direktive UpdateInis referenziert wird, ersetzt, fügt oder löscht ein Abschnitt, der von UpdateIniFields referenziert wird, Elemente einer Zeile in einer bestehenden INI-Datei, anstatt den gesamten Wert einer bestimmten Zeile zu beeinflussen. Mindestens einer der Werte old-field und/oder new-field muss in jedem Abschnittseintrag angegeben werden.
Alle Kommentare in einer zu ändernden Zeile der INI-Datei werden entfernt, da sie nach Änderungen gemäß diesem Abschnitt möglicherweise nicht mehr anwendbar sind. Bei der Suche nach Feldern in der Zeile in den INI-Dateien werden Leerzeichen, Tabulatoren und Kommas als Feldbegrenzer interpretiert. Allerdings wird ein Leerzeichen als Standardtrennzeichen verwendet, wenn ein neues Feld an eine Zeile angehängt wird.
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 bereitgestellten INF-Dateien verwenden Sie die Abschnitte SourceDisksNames und SourceDisksFiles dieser INF, um explizit den vollständigen Pfad jeder benannten Quelldatei anzugeben, 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.