INF CopyFiles 指令

项目
02/02/2024

CopyFiles 指令可以执行以下任一操作：

导致单个文件从源媒体复制到默认目标目录。
在 INF 中引用一个或多个 INF 编写器定义的部分，其中每个节指定要从源媒体复制到目标的文件列表。

[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)
  
CopyFiles=@filename | file-list-section[, file-list-section]...

可以在形式语法语句中显示的任何部分中指定 CopyFiles 指令。还可以在以下任一 INF 节中指定此指令：

由 DDInstall 中的 INF AddInterface 指令引用的 add-interface-section。“接口”部分。
INF InterfaceInstall32 节中引用的 install-interface-section

CopyFiles 指令引用的每个命名节都有一个或多个以下形式的条目：

[file-list-section]
destination-file-name[,[source-file-name][,[unused][,flag]]]
...

INF 编写器定义的 file-list-section 可以包含任意数量的条目，每个条目位于单独的行上。

每个 file-list-section 都可以具有以下格式的可选关联 file-list-section.security 节：

[file-list-section.security]
"security-descriptor-string"

项

destination-file-name
指定目标文件的名称。如果未提供 source-file-name ，则此规范也是源文件的名称。

source-file-name
指定源文件的名称。如果文件复制操作的源文件名和目标文件名相同，则可以省略 source-file-name 。

unused
Windows 2000 及更高版本的 Windows 不再支持此项。

flag
这些可选标志（以十六进制表示法表示或部分条目中的十进制值表示）可用于控制如何 (或是否将特定源文件) 复制到目标。可以为以下系统定义标志指定一个或多个 (ORed) 值。但是，其中一些标志是互斥的：

0x00000001 (COPYFLG_WARN_IF_SKIP)
如果用户选择不复制文件，则发送警告。此标志和下一个标志互斥，两者与经过数字签名的 INF 文件无关。

0x00000002 (COPYFLG_NOSKIP)
不允许用户跳过复制文件。如果驱动程序包已签名，则此标志是隐含的。

0x00000004 (COPYFLG_NOVERSIONCHECK)
忽略文件版本并写入目标目录中的现有文件。此标志和接下来的两个标志是互斥的。此标志与数字签名的 INF 文件无关。

0x00000008 (COPYFLG_FORCE_FILE_IN_USE)
强制文件使用行为：如果当前打开，则不要复制同名的现有文件。请改为复制具有临时名称的给定源文件，以便在下次重启时重命名和使用该文件。

0x00000010 (COPYFLG_NO_OVERWRITE)
不要将目标目录中的现有文件替换为同名的源文件。此标志不能与任何其他标志组合使用。

0x00000020 (COPYFLG_NO_VERSION_DIALOG)
如果现有文件比源文件新，请不要使用源文件写入目标目录中的文件。

较新的检查使用文件版本完成，如从VS_VERSIONINFO文件版本资源中提取的那样。有关详细信息，请参阅版本信息。如果目标文件不是可执行文件或资源映像，或者该文件不包含文件版本信息，则设备安装假定目标文件较旧。

0x00000040 (COPYFLG_OVERWRITE_OLDER_ONLY)
仅当目标上的文件被较新版本取代时，才将源文件复制到目标目录。此标志与数字签名的 INF 文件无关。版本检查使用上述COPYFLG_NO_VERSION_DIALOG中所述的过程相同。

0x00000400 (COPYFLG_REPLACEONLY)
仅当文件已存在于目标目录中时，才将源文件复制到目标目录。

0x00000800 (COPYFLG_NODECOMP) (Windows 7 及更高版本)
将源文件复制到目标目录，如果源文件已压缩，则不解压缩源文件。

0x00001000 (COPYFLG_REPLACE_BOOT_FILE)
系统加载程序需要此文件。系统将提示用户重启系统。

0x00002000 (COPYFLG_NOPRUNE)
请勿由于优化而删除此操作。

例如，Windows 可能会确定文件复制操作没有必要，因为该文件已存在。但是，INF 的编写者知道该操作是必需的，并指示 Windows 重写其优化并执行文件操作。

如果文件也在 INF DelFiles 指令或 INF RenFiles 指令中指定，则此标志可用于确保复制文件。

0x00004000 (COPYFLG_IN_USE_RENAME)
如果由于正在使用目标文件而无法复制源文件，请重命名目标文件，然后将源文件复制到目标文件，然后删除重命名的目标文件。如果无法重命名目标文件，请在下一次系统重启期间完成复制操作。如果无法删除重命名的目标文件，请在下一次系统重启期间删除重命名的目标文件。

security-descriptor-string
指定要应用于由命名 file-list-section 复制的所有文件的安全描述符。 security-descriptor-string 是一个包含标记的字符串，用于指示 DACL (D：) 安全组件。

有关安全描述符字符串的信息，请参阅安全描述符定义语言 (Windows) 。

如果未指定 file-list-section.security 节，文件将继承文件复制到的目录的安全特征。

如果指定了 file-list-section.security 节，则必须包括以下 ACE，以便安装和升级设备和系统 Service Pack：

(A;;Ga;;;SY) • 授予对本地系统的所有访问权限。
(A;;Ga;;;BA) • 向内置管理员授予所有访问权限。

不要指定向非特权用户授予写入访问权限的 ACE 字符串。

有关如何指定安全描述符的详细信息，请参阅创建安全设备安装。

注解

如果文件具有 INF CopyFiles 指令，则 Windows 仅在安装驱动程序过程中将驱动程序包复制到其目标位置。复制文件时，操作系统会在必要时自动生成临时文件名，并在下次启动操作系统时重命名复制的源文件。

INF 文件编写器还必须使用 INF SourceDisksNames 节和 INF SourceDisksFiles 部分为从源媒体复制的文件提供路径规范，以显式指定每个源文件相对于源媒体中的 INF 文件的路径。

复制操作的目标由 INF DestinationDirs 部分控制。本部分控制所有文件复制操作的目标，如下所示：

如果 CopyFiles 指令引用的命名节在同一 INF 的 DestinationDirs 节中具有相应的条目，则该条目显式指定目标目录，该目标目录将在其中复制命名节中列出的所有文件。如果已命名节未在 DestinationDirs 部分列出，则 Windows 将使用 INF 文件的 DestinationDirs 节中的 DefaultDestDir 条目。
如果 CopyFiles 指令使用@文件名语法，则 Windows 将使用 INF 文件的 DestinationDirs 节中的 DefaultDestDir 条目。

以下几点适用于 INF CopyFiles 指令：

每个 file-list-section 名称对于 INF 文件必须是唯一的，但它可由同一 INF 文件中其他位置的 CopyFiles、 DelFiles 或 RenFiles 指令引用。节名称必须遵循 INF 文件的一般语法规则中所述的一般规则。
文件名或 file-list-section 条目中指定的@文件名必须是源媒体上文件的确切名称。不能使用 %strkey% 令牌来指定文件名。有关 %strkey% 令牌的详细信息，请参阅 INF 字符串部分。
CopyFiles 指令不支持使用系统定义的平台扩展名 (.nt、.ntx86、.ntia64 或 .ntamd64) 修饰文件列表节名称。
请勿使用 CopyFiles 指令来复制 INF 文件。有关详细信息，请参阅复制 INF 文件。

从 Windows Vista 开始，以下几点也适用于 INF CopyFiles 指令：

在驱动程序存储中暂存驱动程序包时，仅当文件具有相应的 INF CopyFiles 指令时，文件才会从驱动程序包源复制到驱动程序存储。
作为 Windows 升级的一部分，如果文件具有 INF CopyFiles 指令，则 Windows 仅在驱动程序迁移过程中将驱动程序包文件复制到驱动程序存储。

示例

此示例演示 SourceDisksNames、 SourceDisksFiles 和 DestinationDirs 部分如何指定在处理简单设备驱动程序 INF 时发生的复制文件操作的路径。

[SourceDisksNames]
1 = %Floppy_Description%,,,\WinNT

[SourceDisksFiles.x86]
aha154x.sys = 2,\x86 ; on distribution disk 2, in subdir \WinNT\x86

[DestinationDirs]
DefaultDestDir = 13

; ... Manufacturer and Models sections omitted here

[AHA154X.NTx86]
CopyFiles=@AHA154x.SYS 
; ... some other directives and sections omitted here
; ...

有关如何使用 INF CopyFiles 指令的其他示例，请参阅包含在 Windows 驱动程序工具包 的 src 目录中的设备驱动程序示例的 INF 文件 (WDK) 。