INF RenFiles-instructie

Caution

Als u een universeel of Windows stuurprogrammapakket bouwt, is deze richtlijn niet geldig. Zie Een universeel INF-bestand gebruiken en aan de slag met het ontwikkelen van Windows stuurprogramma's.

Een RenFiles-instructie verwijst naar een inF-schrijver gedefinieerde sectie elders in het INF-bestand, waardoor die lijst met bestanden wordt hernoemd in de context van bewerkingen in de sectie waarin de verwijzende RenFiles-instructie is opgegeven.

[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]...

Een RenFiles-instructie kan worden opgegeven in een van de secties die worden weergegeven in de formele syntaxisinstructie. Deze richtlijn kan ook worden opgegeven in een van de volgende inF-schrijver gedefinieerde secties:

Elke benoemde sectie waarnaar wordt verwezen door een RenFiles-instructie heeft een of meer vermeldingen van het volgende formulier:

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

Een bestandslijstsectie kan een willekeurig aantal vermeldingen bevatten, elk op een afzonderlijke regel.

Invoer

new-dest-file-name
Hiermee geeft u de nieuwe naam die moet worden gegeven aan het bestand op de bestemming.

old-source-file-name
Hiermee geeft u de oude naam van het bestand.

Remarks

Important

Deze richtlijn moet zorgvuldig worden gebruikt. We raden u ten zeerste aan om de RenFiles-instructie niet te gebruiken in het INF-bestand voor een Plug en Play (PnP)-functiestuurprogramma.

Elke naam van een bestandslijstsectie moet uniek zijn voor het INF-bestand, maar kan worden verwezen door de instructies CopyFiles, DelFiles of RenFiles elders in dezelfde INF. Een dergelijke inF-schrijver gedefinieerde sectienaam moet voldoen aan de algemene regels voor het definiƫren van sectienamen. Zie Algemene syntaxisregels voor INF-bestanden voor meer informatie over deze regels.

De RenFiles-instructie biedt geen ondersteuning voor het decoreren van een bestandslijstsectienaam met een door het systeem gedefinieerde platformextensie (.nt, .ntx86, .ntia64, .ntamd64, .ntarm of .ntarm64).

De sectie DestinationDirs van het INF-bestand bepaalt de bestemming voor alle bewerkingen voor bestandsnamen, ongeacht de sectie die een bepaalde RenFiles-instructie bevat. In de volgende regels wordt de bewerking voor het wijzigen van de bestandsnaam beschreven:

  • Als een benoemde sectie waarnaar wordt verwezen door een RenFiles-instructie een overeenkomende vermelding heeft in de sectie DestinationDirs in hetzelfde INF, geeft die vermelding expliciet de doellocatiemap op. Alle bestanden die in de benoemde sectie worden vermeld, worden op het doel hernoemd voordat deze bronbestanden worden gekopieerd.

  • Als een benoemde sectie niet wordt vermeld in de sectie DestinationDirs, gebruikt Windows de vermelding DefaultDestDir in de sectie DestinationDirs van de INF.

Note

U kunt geen %strkey% token gebruiken om de nieuwe of oude bestandsnamen op te geven. Zie de sectie INF-tekenreeksen voor meer informatie over %strkey% tokens.

Examples

In dit voorbeeld ziet u een sectie waarnaar wordt verwezen door een RenFiles-instructie .

[RenameOldFilesSec]
devfile41.sav, devfile41.sys

Zie ook

AddInterface

ClassInstall32

CopyFiles

DDInstall

DelFiles

DestinationDirs

InterfaceInstall32

SourceDisksFiles

SourceDisksNames

Tekenreeksen

Versie