INF RenFiles 指示詞
警告
如果您要建置通用或 Windows 驅動程式套件，則這個指示詞無效。 請參閱 使用通用 INF 檔案 和 開始開發 Windows 驅動程式。
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 寫入器定義的區段中指定這個指示詞：
- AddInterface 指示詞在 DDInstall 中參考的 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 指示詞不支援以系統定義的平台擴展名裝飾 file-list-section 名稱（.nt、.ntx86、.ntia64、.ntamd64、.ntarm 或 .ntarm64）。
不論包含特定 RenFiles 指示詞的區段為何，INF 檔案的 DestinationDirs 區段都會控制所有檔案重新命名作業的目的地。 下列規則描述檔案重新命名作業：
如果 RenFiles 指示詞所參考的具名區段在相同 INF 的 DestinationDirs 區段中有對應的專案，該專案會明確指定目標目的地目錄。 在複製這些來源檔案之前，所有列在具名區段中的檔案都會在目的地上重新命名。
如果未在 DestinationDirs 區段中列出具名區段，Windows 會在 INF 的 DestinationDirs 區段中使用 DefaultDestDir 專案。
注意
您無法使用 %strkey% 令牌來指定新的或舊的檔案名。 如需 %strkey% 令牌的詳細資訊，請參閱 INF 字串一節。
範例
此範例顯示 RenFiles 指示詞所參考的區段。
[RenameOldFilesSec]
devfile41.sav, devfile41.sys