INF UpdateIniFields 指示詞
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 檔案的指定行中搜尋相符專案。
位一 = 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 項目中識別。