INF Ini2Reg 指令

项目
07/20/2023

注意

从 Windows 11 版本 22H2 开始，使用此指令的驱动程序包不再有资格从硬件开发人员中心获得签名。

Ini2Reg 指令引用一个或多个命名节，其中提供的 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)
  
Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...

Ini2Reg 指令引用的每个命名节具有以下形式：

[ini-to-registry-section]
 
ini-file,ini-section,[ini-key],reg-root,subkey[,flags]
...

ini-to-registry-section 可以具有由 INF 编写器确定的任何条目数，每个条目在单独的行上。

项

ini-file
指定源媒体上提供的 INI 文件的名称。此值可以表示为在 INF 文件的 Strings 节中定义的文件名或 %strkey% 标记。

ini-section
指定给定 INI 文件中包含要复制的注册表信息的节的名称。

ini-key
指定要复制到注册表的 INI 文件中的项的名称。如果省略此值，则将整个 ini-section 传输到指定的注册表子项。

reg-root
标识此条目中提供的其他值的注册表树的根。有关细节，请参阅 AddReg 指令的参考。

subkey
标识要接收值的子项，表示为在 INF 的 Strings 节中定义的 %strkey% 标记，或者表示为给定 reg 根 (key1\key2\key3...) 的显式注册表路径。

flag
指定第 0 位 () 在将给定信息传输到注册表后如何处理 INI 文件，并在第 1 位 () 是否覆盖现有注册表信息，如下所示：

位零 = 0
请勿在将 INI 文件复制到注册表后从该文件中删除给定信息。这是默认值。

位零 = 1
将 INI 文件移动到注册表后，请从该文件中删除给定的信息。

位 1 = 0
如果注册表中已存在指定的子项，请不要将 INI 提供的信息传输到此子项中。否则，请在注册表中创建指定的子项，并将此 INI 提供的信息作为其值条目。这是默认值。

位 1 = 1
如果注册表中已存在指定的子项，请使用 INI 提供的信息替换其值项。

注解

Ini2Reg 指令在形式语法语句中显示的任何部分中都有效。此指令在 AddInterface 指令引用或 InterfaceInstall32 节中引用的 INF 编写器定义的节中也有效。

如果使用 INF 文件在 Windows XP 和更高版本的 Windows 上安装设备，则 INF 文件不应包含 Ini2Reg 指令。包含 Ini2Reg 指令的 INF 文件不会通过 “专为 Windows 设计”徽标测试，也不会收到数字签名，因此 Windows 将不受信任 (请参阅 Windows 如何) 选择驱动程序。

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

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

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