INF RenFiles Direktive
Achtung
Wenn Sie ein Universal- oder Windows-Treiber-Paket erstellen, ist diese Direktive nicht gültig. Siehe Verwenden einer universellen INF-Datei und Erste Schritte bei der Entwicklung von Windows-Treibern.
Eine Direktive RenFiles verweist auf einen von einem INF-Autor*innen definierten Abschnitt an anderer Stelle in der INF-Datei. Dadurch wird diese Liste von Dateien im Kontext der Vorgänge in dem Abschnitt umbenannt, in dem die verweisende Direktive RenFiles 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 Syntaxanweisung aufgeführt sind. Diese Direktive kann auch in einem der folgenden von INF-Autor*innen definierten Abschnitte angegeben werden:
- Ein add-interface-section, der von der Direktive AddInterface in einem DDInstall.Interfaces-Abschnitt referenziert wird.
- Ein install-interface-section, auf den in einem InterfaceInstall32-Abschnitt verwiesen wird.
Jeder benannte Abschnitt, auf den eine Direktive RenFiles verweist, hat einen oder mehrere Einträge der folgenden Form:
[file-list-section]
new-dest-file-name,old-source-file-name
...
Ein file-list-section kann eine beliebige Anzahl von Einträgen haben, die jeweils in einer eigenen Zeile stehen.
Entries
new-dest-file-name
Gibt den neuen Namen an, den die Datei am Zielort erhalten soll.
old-source-file-name
Gibt den alten Namen der Datei an.
Hinweise
Wichtig
Diese Direktive muss mit Bedacht verwendet werden. Wir empfehlen Ihnen dringend, die Direktive RenFiles nicht in der INF-Datei für einen Plug-and-Play (PnP)-Funktionstreiber zu verwenden.
Jeder file-list-section-Name muss für die INF-Datei eindeutig sein, kann aber durch CopyFiles, DelFiles oder RenFiles-Direktiven an anderer Stelle in derselben INF referenziert werden. Ein solcher von INF-Autor*innen definierter Abschnittsname muss 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 Direktive RenFiles unterstützt nicht die Auszeichnung eines file-list-section-Namens mit einer systemdefinierten Erweiterung (.nt, .ntx86, .ntia64, .ntamd64, .ntarm oder .ntarm64).
Der Abschnitt DestinationDirs der INF-Datei steuert das Ziel für alle Vorgänge zum Umbenennen von Dateien, unabhängig von dem Abschnitt, der eine bestimmte RenFiles-Direktive enthält. Die folgenden Regeln beschreiben den Vorgang des Umbenennens von Dateien:
Wenn ein benannter Abschnitt, auf den eine Direktive RenFiles verweist, einen entsprechenden Eintrag im Abschnitt DestinationDirs in derselben INF hat, gibt dieser Eintrag das Zielverzeichnis explizit an. Alle Dateien, die in dem benannten Abschnitt aufgeführt sind, werden am Zielort 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 der INF.
Hinweis
Sie können das Token %strkey% nicht verwenden, um die neuen oder alten Dateinamen anzugeben. Weitere Informationen über %strkey% Token finden Sie unter INF Zeichenfolgen Abschnitt.
Beispiele
Dieses Beispiel zeigt einen Abschnitt, der von einer RenFiles-Direktive referenziert wird.
[RenameOldFilesSec]
devfile41.sav, devfile41.sys