INF RenFiles 指示詞

警告

如果您要建置通用或 Windows 驅動程式套件，這個指示詞無效。 請參閱搭配 Windows 驅動程式使用通用 INF 檔案和 使用者入門。

RenFiles 指示詞會參考 INF 檔案中其他位置的 INF 寫入器定義區段，這會導致在指定參考 RenFiles 指示詞之區段的作業內容中重新命名該檔案清單。

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

RenFiles 指示詞可以在正式語法語句中顯示的任何區段內指定。 您也可以在下列任何 INF 寫入器定義的區段內指定這個指示詞：

• DDInstall 中 AddInterface 指示詞所參考的 add-interface-section。介面區段。
• InterfaceInstall32 區段中參考的 install-interface-section。

RenFiles 指示詞所參考的每個具名區段都有一或多個下列格式的專案：

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

file-list-section 可以有任意數目的專案，每個專案都位於個別行上。

項目

new-dest-file-name
指定要在目的地上提供給檔案的新名稱。

old-source-file-name
指定檔案的舊名稱。

備註

重要

這個指示詞必須謹慎使用。 強烈建議您不要將 INF 檔案中的 RenFiles 指示詞用於 隨插即用 (PnP) 函式驅動程式。

任何 file-list-section 名稱都必須對 INF 檔案是唯一的，但可由 CopyFiles、 DelFiles 或 RenFiles 指示詞參考相同的 INF 中其他位置。 這類 INF 寫入器定義的區段名稱必須遵循定義區段名稱的一般規則。 如需這些規則的詳細資訊，請參閱 INF 檔案的一般語法規則。

RenFiles 指示詞不支援以系統定義的平臺擴展名裝飾檔案清單區段名稱， (.nt、.ntx86、.ntia64、.ntamd64、.ntarm 或 .ntarm64) 。

INF 檔案的 DestinationDirs 區段會控制所有檔案重新命名作業的目的地，而不論包含特定 RenFiles 指示詞的 區段為何。 下列規則描述檔案重新命名作業：

• 如果 RenFiles 指示詞所參考的具名區段在相同 INF 的 DestinationDirs 區段中有對應的專案，該專案會明確指定目標目的地目錄。 在複製這些來源檔案之前，所有列在具名區段中的檔案都會重新命名在目的地上。

• 如果未在 DestinationDirs 區段中列出具名區段，Windows 會在 INF 的 DestinationDirs 區段中使用 DefaultDestDir 專案。

注意

您無法使用 %strkey% 令牌來指定新的或舊的檔案名。 如需 %strkey% Token 的詳細資訊，請參閱 INF 字串一節。

範例

此範例顯示 RenFiles 指示詞所參考的區段。

[RenameOldFilesSec]
devfile41.sav, devfile41.sys

另請參閱

AddInterface

ClassInstall32

CopyFiles

DDInstall

DelFiles

DestinationDirs

InterfaceInstall32

SourceDisksFiles

SourceDisksNames

字串

版本