INF RenFiles-direktiv

Caution

Om du skapar ett universellt eller Windows Drivrutinspaket är det här direktivet inte giltigt. Se Använda en Universell INF-fil och Kom igång med att utveckla Windows drivrutiner.

Ett RenFiles-direktiv refererar till ett INF-skrivardefinierat avsnitt någon annanstans i INF-filen, vilket gör att listan över filer byts namn i samband med åtgärder i avsnittet där det refererande RenFiles-direktivet anges.

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

Ett RenFiles-direktiv kan anges i något av de avsnitt som visas i den formella syntaxsatsen. Det här direktivet kan också anges i något av följande INF-skrivardefinierade avsnitt:

Varje namngivet avsnitt som refereras till av ett RenFiles-direktiv har en eller flera poster i följande formulär:

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

Ett fil-list-avsnitt kan ha valfritt antal poster, var och en på en separat rad.

Inlägg

new-dest-file-name
Anger det nya namn som ska ges till filen på målet.

old-source-file-name
Anger det gamla namnet på filen.

Remarks

Important

Detta direktiv måste användas noggrant. Vi rekommenderar starkt att du inte använder RenFiles-direktivet i INF-filen för en technológia Plug and Play-funktionsdrivrutin (PnP).

Alla fillistavsnittsnamn måste vara unika för INF-filen, men det kan refereras till av CopyFiles-, DelFiles- eller RenFiles-direktiv någon annanstans i samma INF. Ett sådant INF-skrivskyddat avsnittsnamn måste följa de allmänna reglerna för att definiera avsnittsnamn. Mer information om dessa regler finns i Allmänna syntaxregler för INF-filer.

RenFiles-direktivet stöder inte att ett fillisteavsnittsnamn dekoreras med ett systemdefinierat plattformstillägg (.nt, .ntx86, .ntia64, .ntamd64, .ntarm eller .ntarm64).

Avsnittet DestinationDirs i INF-filen styr målet för alla filbytesåtgärder, oavsett vilket avsnitt som innehåller ett visst RenFiles-direktiv . Följande regler beskriver åtgärden för filbyte:

  • Om ett namngivet avsnitt som refereras till av ett RenFiles-direktiv har en motsvarande post i avsnittet DestinationDirs i samma INF anger posten uttryckligen målmålkatalogen. Alla filer som visas i det namngivna avsnittet byt namn på målet innan dessa källfiler kopieras.

  • Om ett namngivet avsnitt inte visas i avsnittet DestinationDirs använder Windows posten DefaultDestDir i avsnittet DestinationDirs i INF.

Note

Du kan inte använda en %% token för att ange de nya eller gamla filnamnen. Mer information om %strkey -% token finns i avsnittet INF-strängar.

Examples

Det här exemplet visar ett avsnitt som refereras till av ett RenFiles-direktiv .

[RenameOldFilesSec]
devfile41.sav, devfile41.sys

Se även

Lägg tillInterface

ClassInstall32

CopyFiles

DDInstall

DelFiles

DestinationDirs

InterfaceInstall32

SourceDisksFiles

SourceDisksNames

Strängar

Version