共用方式為


INF UpdateIniFields 指示詞

警告

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

通用驅動程式套件Windows 驅動程式 無法使用這個指示詞。

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 項目中識別。

另請參閱

AddInterface

ClassInstall32

DDInstall

Ini2Reg

InterfaceInstall32

SourceDisksFiles

SourceDisksNames

字串

UpdateInis

版本