INF RenFiles-Direktive

Artikel
06/15/2023

Achtung

Wenn Sie ein universelles Oder Windows-Treiberpaket erstellen, ist diese Anweisung ungültig. Weitere Informationen finden Sie unter Verwenden einer universellen INF-Datei und Erste Schritte mit Windows-Treibern.

Eine RenFiles-Direktive verweist auf einen inF-Writer definierten Abschnitt an anderer Stelle in der INF-Datei, wodurch diese Liste der Dateien im Kontext von Vorgängen für den Abschnitt umbenannt wird, in dem die verweisende RenFiles-Direktive angegeben ist.

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

Renfiles=file-list-section[,file-list-section]...

Eine RenFiles-Direktive kann in jedem der Abschnitte angegeben werden, die in der formalen Syntax-Anweisung angezeigt werden. Diese Direktive kann auch in einem der folgenden INF-Writer-definierten Abschnitte angegeben werden:

Ein add-interface-section , auf den die AddInterface-Anweisung in einem DDInstall verweist. Abschnitt "Schnittstellen" .
Ein abschnitt install-interface, auf den in einem Abschnitt InterfaceInstall32 verwiesen wird.

Jeder benannte Abschnitt, auf den von einer RenFiles-Direktive verwiesen wird, weist mindestens einen Eintrag der folgenden Form auf:

[file-list-section]
 
new-dest-file-name,old-source-file-name 
...

Ein file-list-section kann eine beliebige Anzahl von Einträgen in einer separaten Zeile enthalten.

Einträge

new-dest-file-name
Gibt den neuen Namen an, der der Datei auf dem Ziel zugewiesen werden soll.

old-source-file-name
Gibt den alten Namen der Datei an.

Hinweise

Wichtig

Diese Anweisung muss sorgfältig verwendet werden. Es wird dringend empfohlen, die RenFiles-Direktive in der INF-Datei für einen PnP-Funktionstreiber (Plug & Play) nicht zu verwenden.

Jeder Dateiliste-Abschnittsname muss für die INF-Datei eindeutig sein, kann jedoch durch CopyFiles-, DelFiles- oder RenFiles-Direktiven an anderer Stelle im selben INF darauf verwiesen werden. Ein solcher inF-Writer definierter Abschnittsname muss den allgemeinen Regeln zum Definieren von Abschnittsnamen entsprechen. Weitere Informationen zu diesen Regeln finden Sie unter Allgemeine Syntaxregeln für INF-Dateien.

Die RenFiles-Direktive unterstützt nicht das Dekorieren eines Dateilistenabschnittsnamens mit einer systemdefinierten Plattformerweiterung (.nt, .ntx86, .ntia64, .ntamd64, .ntarm oder .ntarm64).

Der Abschnitt DestinationDirs der INF-Datei steuert das Ziel für alle Dateiumbenennungsvorgänge unabhängig vom Abschnitt, der eine bestimmte RenFiles-Direktive enthält. Die folgenden Regeln beschreiben den Vorgang zum Umbenennen von Dateien:

Wenn ein benannter Abschnitt, auf den von einer RenFiles-Direktive verwiesen wird, einen entsprechenden Eintrag im Abschnitt DestinationDirs im selben INF enthält, gibt dieser Eintrag explizit das Zielzielverzeichnis an. Alle Dateien, die im benannten Abschnitt aufgeführt sind, werden im Ziel umbenannt, bevor diese Quelldateien kopiert werden.
Wenn ein benannter Abschnitt nicht im Abschnitt DestinationDirs aufgeführt ist, verwendet Windows den Eintrag DefaultDestDir im Abschnitt DestinationDirs des INF.

Hinweis

Sie können kein %strkey%-Token verwenden, um die neuen oder alten Dateinamen anzugeben. Weitere Informationen zu %strkey%-Token finden Sie im Abschnitt "INF-Zeichenfolgen".

Beispiele

Dieses Beispiel zeigt einen Abschnitt, auf den eine RenFiles-Direktive verweist.

[RenameOldFilesSec]
devfile41.sav, devfile41.sys

Weitere Informationen

InterfaceInstall32