INF UpdateIniFields-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 Direktive nicht verwenden.

Eine UpdateIniFields-Direktive verweist auf einen oder mehrere benannte Abschnitte, in denen differenzierte Ä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, auf den von einer UpdateIniFields-Direktive verwiesen wird, hat die folgende Form:

[update-inifields-section]
 
ini-file,ini-section,profile-name[,old-field][,new-field][,flags]
...

Ein Update-inifields-Abschnitt kann eine beliebige durch INF-Writer bestimmte Anzahl von Einträgen in einer separaten Zeile enthalten.

Einträge

ini-datei
Gibt den Namen einer AUF DEM Quellmedium bereitgestellten INI-Datei und implizit den Namen einer zu aktualisierenden INI-Datei auf dem Zielcomputer 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 den angegebenen INI-Dateien an, der die zu ändernde Zeile enthält.

Profilname
Gibt den Namen der Zeile an, die innerhalb des angegebenen INI-Abschnitts geändert werden soll. Es muss mindestens einer der Einträge old-field und/oder new-field angegeben werden, um eine Änderung dieser Zeile zu bewirken.

old-field
Gibt ein vorhandenes Feld innerhalb der angegebenen Zeile an. Wenn new-field in diesem Abschnittseintrag ausgelassen wird, wird dieses Feld aus der angegebenen Zeile gelöscht. Andernfalls sollte der angegebene new-field-Wert dieses Feld ersetzen.

new-field
Gibt einen Ersatz für ein bestimmtes altes Feld oder, wenn ein altes Feld ausgelassen wird, eine Ergänzung zur angegebenen Zeile an.

flags
Gibt (in Bit 0) an, wie ein altes-Feld und/oder neues-Feld interpretiert wird, wenn eines oder beide ein Sternchen (*) enthalten, und/oder (in Bit 1), welches Trennzeichen verwendet werden soll, wenn ein bestimmtes new-field an die angegebene Zeile angefügt wird, wie folgt:

Bit 0 = 0
Interpretieren Sie bei der Suche nach einer Übereinstimmung in der angegebenen Zeile der INI-Datei jedes Sternchen (*) in den angegebenen Einträgen für alte Felder und/oder neue Felder wörtlich, nicht als Wild-Karte-Zeichen. Dies ist der Standardwert.

Bit 0 = 1
Interpretieren Sie ein Sternchen (*) in den angegebenen Einträgen für alte Felder und/oder neue Felder als Karte Zeichen, wenn Sie in der angegebenen Zeile der INI-Datei nach einer Übereinstimmung suchen.

Bit 1 = 0
Verwenden Sie ein Leerzeichen als Trennzeichen, wenn Sie den angegebenen New-Field-Eintrag zur angegebenen Zeile der INI-Datei hinzufügen. Dies ist der Standardwert.

Bit 1 = 1
Verwenden Sie ein Komma (,) als Trennzeichen, wenn Sie der angegebenen Zeile der INI-Datei den angegebenen New-Field-Eintrag hinzufügen.

Hinweise

Die UpdateIniFields-Direktive wird in INF-Dateien für Installationen unter Windows fast nie angegeben, da es nicht erforderlich ist, INI-Dateien auf ihren Verteilungsmedien zu haben. Die UpdateIniFields-Direktive ist jedoch in allen Abschnitten gültig, die in der formalen Syntax-Anweisung sowie in in INF-writer-definierten Abschnitten angezeigt werden, auf die von einer AddInterface-Direktive verwiesen wird oder auf die in einem InterfaceInstall32-Abschnitt verwiesen wird.

Jeder Update-inifields-Abschnittsname 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.

Im Gegensatz zu einem Abschnitt, auf den von der UpdateInis-Direktive verwiesen wird, ersetzt, fügt oder löscht ein Abschnitt, auf den von UpdateIniFields verwiesen wird, Teile einer Zeile in einer vorhandenen INI-Dateizeile, anstatt den gesamten Wert einer bestimmten Zeile zu beeinflussen. In jedem Abschnittseintrag muss mindestens einer der Werte old-field und/oder new-field angegeben werden.

Alle Kommentare in einer zu ändernden INI-Dateizeile werden entfernt, da sie nach änderungen, die gemäß diesem Abschnitt vorgenommen wurden, möglicherweise nicht anwendbar sind. Bei der Suche nach Feldern in der Zeile in den INI-Dateien werden Leerzeichen, Registerkarten und Kommas als Feldtrennzeichen interpretiert. Ein Leerzeichen wird jedoch als Standardtrennzeichen verwendet, wenn ein neues Feld an eine Zeile angefügt wird.

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 können Sie mithilfe der Abschnitte SourceDisksNames und SourceDisksFiles dieses INF explizit den vollständigen Pfad jeder benannten Quelldatei angeben, 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 angeben, die im LayoutFile-Eintrag im Abschnitt Version der INF-Datei angegeben sind.