INF UpdateIniFields 指示詞

發行項
02/07/2024

警告

從 Windows 11 22H2 版開始，使用此指示詞的驅動程式套件不再符合硬體開發人員中心的簽章資格。

UpdateIniFields 指示詞會參考一或多個具名區段，其中可以指定 INI 檔案行內的細微修改。

[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)

UpdateIniFields=update-inifields-section[,update-inifields-section]...

UpdateIniFields 指示詞所參考的每個具名區段都有下列形式：

[update-inifields-section]
 
ini-file,ini-section,profile-name[,old-field][,new-field][,flags]
...

update-inifields-section 可以有任何 INF 寫入器決定的項目數目，每個專案都是在不同的行上。

項目

ini-file
指定來源媒體上提供的 INI 檔名，並隱含指定目標電腦上要更新之 INI 檔案的名稱。此值可以表示為檔名，或以 INF 檔案之 Strings 區段中定義的 %strkey% 令牌表示。

ini-section
指定指定 INI 檔案內要修改之行的區段名稱。

profile-name
指定要在指定 INI 區段中修改之行的名稱。至少必須指定一個 舊欄位 和/或 新欄位 專案，以影響此行的修改。

old-field
指定指定行內現有的欄位。如果從此區段專案省略 new-field ，則會從指定的行中刪除此欄位。否則，指定的新域值應該取代此欄位。

new-field
指定指定 舊欄位 的取代，如果省略 old-field ，則為指定行的新增專案。

flags
指定位 0) 中的 (，如果或兩者都包含星號 (*) ，以及/或 (位 1) 將指定的新字段附加至指定行時，要使用哪一個分隔符，則如何解譯指定的舊-字段和/或新-字段，如下所示：

位零 = 0
在指定的 舊欄位 和/或 新欄位 專案中，解譯任何星號 (*) ，而不是在 INI 檔案的指定行中搜尋相符專案時，而非通配符。這是預設值。

位零 = 1
在 INI 檔案的指定行中搜尋相符專案時，將指定 舊欄位 和/或 新欄位 專案中的任何星號解譯為通配符 (*) 。

位 1 = 0
將指定的 新欄位 專案新增至 INI 檔案的指定行時，請使用空白字元做為分隔符。這是預設值。

位一 = 1
將指定的 新欄位 專案新增至 INI 檔案的指定行時，請使用逗號 (，) 做為分隔符。

備註

UpdateIniFields 指示詞幾乎永遠不會在 WINDOWS 上安裝的 INF 檔案中指定，因為它不需要在其散發媒體上擁有 INI 檔案。不過， UpdateIniFields 指示詞在正式語法語句中顯示的任何區段，以及 AddInterface 指示詞所參考的 INF 寫入器定義區段，或在 InterfaceInstall32 區段中參考的區段有效。

每個 update-inifields-section 名稱都必須是唯一的 INF 檔案。每個 INF 寫入器建立的區段名稱在 INF 檔案內必須是唯一的，而且必須遵循定義區段名稱的一般規則。如需這些規則的詳細資訊，請參閱 INF 檔案的一般語法規則。

不同於 UpdateInis 指示詞所參考的區段， UpdateIniFields 所參考的區段會取代、新增或刪除現有 INI 檔案行中某一行的部分，而不是影響特定行的整個值。每個區段專案中至少必須指定一個 舊欄位 和/或新域值。

拿掉待修改 INI 檔案行中的任何批注，因為根據本節所做的變更之後，這些批注可能不適用。在 INI 檔案的行中尋找欄位時，空格、索引標籤和逗號會解譯為欄位分隔符。不過，當新欄位附加至行時，會使用空格字元做為預設分隔符。

INF 會以下列其中一種方式，在散發媒體上提供指定 ini-file 的完整路徑：

在 IHV/OEM 提供的 INF 檔案中，使用此 INF 的 SourceDisksNames 和 SourceDisksFiles 區段，明確指定不在根目錄 (或發佈媒體上) 之每個具名來源檔案的完整路徑。
在系統提供的 INF 檔案中，藉由提供一或多個額外的 INF 檔案，在 INF 檔案的 Version 區段中的 LayoutFile 項目中識別。