Skip to main content

WdCopySearchOptions

指定复制操作的文件和目录筛选模式。

语法

成员

_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
类型:uint64_t
一个位掩码,指示文件必须具有哪些文件属性才会被包含在复制中。设置为 0 表示不按属性筛选。有关文件属性的更多信息,请参阅文件属性常量 excludeFileAttributes
类型:uint64_t
一个位掩码,指示哪些文件属性会导致文件从复制中被排除。设置为 0 表示不按属性筛选。有关文件属性的更多信息,请参阅文件属性常量

示例

仅复制 .exe.dll 文件:
从复制中排除名为 temp 的目录:
仅复制只读或系统文件,并排除隐藏文件:
当包含模式和排除模式之间存在冲突时,排除模式优先,该文件将不会被复制。

备注

通过 searchOptions 参数将此结构体传递给 WdRemoteCopy,以筛选复制操作中包含的文件和目录。如果为 searchOptions 传入 nullptr,则所有文件都会被复制而不进行任何筛选。

要求

另请参阅

最后修改于 2026年8月24日