INF UpdateIniFields 指令

项目
07/20/2023

注意

从 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 ，则指定对给定行的补充。

flag
指定位 0 中的 () 如何解释给定的旧-字段和/或新-字段（如果其中一个或两者都包含星号 (*) ）和/或位 1 中的 () 在将给定 的新字段 追加到给定行时要使用的分隔符，如下所示：

位零 = 0
在 INI 文件的给定行中搜索匹配项时，从字面上解释指定旧字段和/或新字段条目中的任何星号 (*) ，而不是作为通配卡字符。这是默认值。

位零 = 1
在 INI 文件的给定行中搜索匹配项时，将指定旧字段和/或新字段条目中的任何星号 (*) 解释为通配卡字符。

位 1 = 0
将指定的 新字段 条目添加到 INI 文件的给定行时，使用空格字符作为分隔符。这是默认值。

位 1 = 1
将指定的 新字段 条目添加到 INI 文件的给定行时，请使用逗号 (，) 作为分隔符。

注解

对于 Windows 上的安装，几乎从未在 INF 文件中指定 UpdateIniFields 指令，因为其分发介质上不需要有 INI 文件。但是， UpdateIniFields 指令在形式语法语句中显示的任意部分以及 由 AddInterface 指令引用或在 InterfaceInstall32 节中引用的 INF 编写器定义的节中有效。

每个 update-inifields-section 名称对于 INF 文件必须是唯一的。 INF 编写器创建的每个节名称在 INF 文件中必须唯一，并且必须遵循定义节名称的一般规则。有关这些规则的详细信息，请参阅 INF 文件的一般语法规则。

与 UpdateInis 指令引用的节不同， UpdateIniFields 引用的节替换、添加或删除现有 INI 文件行中行的各个部分，而不是影响特定行的整个值。必须在每个节条目中指定至少一个旧字段和/或 新字段 值。

将删除待修改的 INI 文件行中的任何注释，因为它们在根据本部分进行更改后可能不适用。在 INI 文件中的行中查找字段时，空格、制表符和逗号被解释为字段分隔符。但是，将新字段追加到行中时，将使用空格字符作为默认分隔符。

INF 通过以下方式之一在分发介质上提供给定 ini 文件 的完整路径：

在 IHV/OEM 提供的 INF 文件中，通过使用此 INF 的 SourceDisksNames 和 SourceDisksFiles 部分显式指定不在分发介质上根目录 (或目录) 的每个命名源文件的完整路径。
在系统提供的 INF 文件中，通过提供一个或多个其他 INF 文件，在 INF 文件的“版本”部分中的 LayoutFile 条目中标识。