WdCopySearchOptions
指定复制操作的文件和目录筛选模式。 引入版本: RIT 0.0.8-Preview。成员类型和可用性因版本而异;请参阅更改历史记录。语法
成员
_In_z_ includeFilePattern类型:const char* 指定要在复制操作中包含哪些文件的 glob 模式(例如
"*" 表示包含所有文件,或 "*.exe;*.dll" 表示只包含可执行文件和 DLL)。
_In_z_ excludeFilePattern类型:const char* 指定要从复制操作中排除哪些文件的 glob 模式(例如
"*.pdb" 表示排除调试符号)。
_In_z_ excludeDirPattern类型:const char* 指定要从复制操作中排除的目录名称(而非路径)的 glob 模式(例如
".vs;obj" 表示排除 Visual Studio 目录和生成输出目录)。
includeFileAttributes类型:uint32_t 文件属性的位掩码。具有任一指定属性的文件将包含在复制中。设置为
0 表示不按属性筛选。有关文件属性的更多信息,请参阅文件属性常量。
excludeFileAttributes类型:uint32_t 导致文件从复制中排除的文件属性位掩码。设置为
0 表示不按属性筛选。有关文件属性的更多信息,请参阅文件属性常量。
includeDirectoryAttributes类型:uint32_t 引入版本: RIT 0.0.13-preview。 目录属性的位掩码。具有任一指定属性的目录将包含在复制中。这与应用于目录的
includeFileAttributes 相同。设置为 0 表示不按属性筛选。
excludeDirectoryAttributes类型:uint32_t 引入版本: RIT 0.0.13-preview。 导致目录从复制中排除的目录属性位掩码。这与应用于目录的
excludeFileAttributes 相同。设置为 0 表示不按属性筛选。
示例
以下名称模式示例使用CopyTo。
仅复制 .exe 和 .dll 文件:
temp 的目录:
当包含模式与排除模式发生冲突时,排除模式优先,该文件将不会被复制。
备注
通过searchOptions 参数将此结构传递给 WdRemoteCopy,以筛选复制操作中包含的文件和目录。如果为 searchOptions 传递 nullptr,则复制所有文件,不进行任何筛选。
更改历史记录
RIT 0.0.13-preview 中的更改改变了结构布局。请使用匹配的 API NuGet 包中的头文件和库重新生成本机调用方;不要将旧的结构布局传递给较新的 API DLL。
