INF UpdateInis-Direktive

Artikel
02/02/2024

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 UpdateInis-Direktive verweist auf einen oder mehrere benannte Abschnitte und gibt eine INI-Datei an, aus der ein bestimmter Abschnitt oder eine bestimmte Zeile gelesen und auf eine vorhandene INI-Datei mit demselben Namen auf dem Zielcomputer angewendet werden soll. Optional können Zeilenänderungen von und zu solchen INI-Dateien im Abschnitt update-ini-angegeben werden.

[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)

UpdateInis=update-ini-section[,update-ini-section]...

Diese Direktive wird in INF-Dateien für die Installation unter Windows fast nie angegeben, da in INI-Dateien keine Notwendigkeit besteht. Die UpdateInis-Direktive ist jedoch in jedem der Abschnitte 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 benannte Abschnitt, auf den von einer UpdateInis-Direktive verwiesen wird, hat die folgende Form:

[update-ini-section]
 
ini-file,ini-section[,old-ini-entry][,new-ini-entry][,flags]
...

Ein update-ini-abschnitt kann eine beliebige inF-writer-festgelegte Anzahl von Einträgen aufweisen, die jeweils in einer separaten Zeile enthalten sind.

Einträge

ini-datei
Gibt den Namen einer AUF dem Quellmedium bereitgestellten INI-Datei und implizit den Namen der AUF dem Zielcomputer zu aktualisierenden 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. Wenn die nächsten beiden Werte angegeben werden, enthält dieser Abschnitt einen Zu ändernden Eintrag. Wenn ein old-ini-eintrag ausgelassen wird, aber ein new-ini-eintrag angegeben wird, wird der neue Eintrag hinzugefügt, während dieser Abschnitt gelesen wird.

old-ini-entry
Dieser optionale Wert gibt den Namen eines Eintrags im angegebenen Ini-Abschnitt an, der in der Regel in der folgenden Form ausgedrückt wird:

"key=value"

Entweder oder beide von Schlüssel und Wert können als %strkey%-Token ausgedrückt werden, die in einem Strings-Abschnitt der INF-Datei definiert sind. Das Sternchen (*) kann als Karte für den Schlüssel oder den Wert angegeben werden.

new-ini-entry
Dieser optionale Wert gibt entweder eine Änderung an einem bestimmten old-ini-eintrag oder das Hinzufügen eines neuen Eintrags an. Dieser Wert kann auf die gleiche Weise wie old-ini-entry ausgedrückt werden.

flags
Dieser optionale Wert steuert die Interpretation des angegebenen old-ini-entry und/oder new-ini-entry. Der Flags-Eintrag kann einer der folgenden numerischen Werte sein:

Wert	Bedeutung
0	Dies ist der Standardwert für den Flags-Eintrag , wenn er nicht angegeben wird. Wenn der angegebene old-ini-entry-Schlüssel in den INI-Dateien vorhanden ist, ersetzen Sie diesen key=value durch den angegebenen new-ini-entry. Nur die Schlüssel in den INI-Dateien müssen übereinstimmen. Der entsprechende Wert jedes solchen Schlüssels wird ignoriert. Um der ZIEL-INI-Datei bedingungslos einen new-ini-entry hinzuzufügen, lassen Sie den Wert old-ini-entry aus dem Eintrag im Abschnitt update-ini des INF aus. Um einen old-ini-entry aus der ZIEL-INI-Datei bedingungslos zu löschen, lassen Sie den Wert new-ini-entry aus.
1	Wenn der angegebene old-ini-entry (key=value) in den INI-Dateien vorhanden ist, ersetzen Sie ihn in der INI-Zieldatei, die den angegebenen new-ini-entry enthält. Sowohl der Schlüssel als auch der Wert des angegebenen old-ini-entry müssen mit denen in den INI-Dateien übereinstimmen, damit eine solche Ersetzung vorgenommen wird, nicht nur ihre Schlüssel wie für den vorherigen Flagwert .
2	Wenn der fürold-ini-entry angegebene Schlüssel in der INI-Zieldatei nicht gefunden werden kann, tun Sie nichts. Andernfalls hängen die vorgenommenen Änderungen wie folgt von Übereinstimmungen ab, die in den INI-Dateien für die angegebenen Schlüssel von old-ini-entry und new-ini-entry gefunden wurden: (1) Wenn der Schlüssel des old-ini-entry in den INI-Dateien vorhanden ist, aber auch der Schlüssel des new-ini-entry, ersetzen Sie den old-ini-entry durch den new-ini-entry in der ZIEL-INI-Datei, und entfernen Sie dann den überflüssigen new-ini-eintrag aus dieser INI-Datei . (2) Wenn der Schlüssel des old-ini-entry in den INI-Dateien vorhanden ist, der Schlüssel des new-ini-entry jedoch nicht, ersetzen Sie den old-ini-entry-Schlüssel durch den Schlüsselnew-ini-entry in der ZIEL-INI-Datei, aber lassen Sie den Wert des old-ini-entry unverändert.
3	Wenn der für old-ini-entry angegebene Schlüssel und Wert in den INI-Dateien nicht gefunden werden kann, tun Sie nichts. Andernfalls hängen die vorgenommenen Änderungen wie folgt von Übereinstimmungen ab, die in den INI-Dateien für die angegebenen Schlüssel und Werte von old-ini-entry und new-ini-entry gefunden wurden: (1) Wenn der schlüssel=wert des old-ini-entry in den INI-Dateien vorhanden ist, aber auch der key=value des new-ini-entry, ersetzen Sie den old-ini-entry durch den new-ini-entry ini-Eintrag in der ZIEL-INI-Datei, und entfernen Sie dann den überflüssigen new-ini-entry aus dieser INI-Datei . (2) Wenn der schlüssel=wert des old-ini-entry in den INI-Dateien vorhanden ist, der new-ini-entry jedoch nicht, ersetzen Sie den old-ini-entry durch den new-ini-entry in der ZIEL-INI-Datei, aber lassen Sie den Wert des old-ini-entry unverändert.

Hinweise

Ein angegebener Name des Update-ini-Abschnitts 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 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.

Jeder Dateiname , der in einem old-ini-entry oder new-ini-entry angegeben wird, sollte das Zielverzeichnis angeben, das diese Datei enthält. Ein solcher Zielverzeichnispfad eines Dateinamens in einem update-ini-section-Eintrag muss als Dirid angegeben werden. Listen mit möglichen Dirid-Werten finden Sie unter Verwenden von Dirids.