跳转到主要内容

WdDeleteSearchOptions

指定删除操作的文件和目录筛选模式。 引入版本: RIT 0.0.13-preview。

语法

成员

includeFilePattern
类型:const char*
包含与指定名称匹配的文件。支持通配符 * 和 ?,多个模式可用分号(;)分隔。默认值为 nullptr,表示包含所有内容。 excludeFilePattern
类型:const char*
排除与指定名称匹配的文件。支持通配符 * 和 ?,多个模式可用分号(;)分隔。默认值为 nullptr,表示不排除任何文件。 excludeDirPattern
类型:const char*
排除与指定名称(而非路径)匹配的目录。支持通配符 * 和 ?。默认值为 nullptr,表示不从删除中排除任何目录。 includeFileAttributes
类型:uint64_t
包含设置了任一指定文件属性的文件。支持的值为 FILE_ATTRIBUTE_READONLY、FILE_ATTRIBUTE_ARCHIVE、FILE_ATTRIBUTE_SYSTEM 和 FILE_ATTRIBUTE_HIDDEN。默认值为 0,表示包含所有属性。有关文件属性的更多信息,请参阅文件属性常量。 excludeFileAttributes
类型:uint64_t
排除设置了任一指定文件属性的文件。支持的值为 FILE_ATTRIBUTE_READONLY、FILE_ATTRIBUTE_ARCHIVE、FILE_ATTRIBUTE_SYSTEM 和 FILE_ATTRIBUTE_HIDDEN。默认值为 0,表示不排除任何属性。有关文件属性的更多信息,请参阅文件属性常量。 includeDirAttributes
类型:uint64_t
包含设置了任一指定文件属性的目录。支持的值为 FILE_ATTRIBUTE_READONLY、FILE_ATTRIBUTE_ARCHIVE、FILE_ATTRIBUTE_SYSTEM 和 FILE_ATTRIBUTE_HIDDEN。默认值为 0,表示包含所有属性。 excludeDirAttributes
类型:uint64_t
排除设置了任一指定文件属性的目录。支持的值为 FILE_ATTRIBUTE_READONLY、FILE_ATTRIBUTE_ARCHIVE、FILE_ATTRIBUTE_SYSTEM 和 FILE_ATTRIBUTE_HIDDEN。默认值为 0,表示不排除任何属性。

示例

仅删除 .pdb 和 .log 文件:
删除除存档数据目录以外的所有内容:
删除已存档的文件,但保留只读文件和隐藏目录:
[!NOTE]
当包含模式与排除模式发生冲突时,排除模式优先,该项将不会被删除。

备注

通过 searchOptions 参数将此结构传递给 WdDeleteRemoteFiles,以筛选选择删除哪些文件和目录。如果为 searchOptions 传递 nullptr,则包含所有项,不进行任何筛选。 这些选项仅在 remoteFolderPath 解析为文件夹时适用。当 remoteFolderPath 解析为单个文件时,将忽略这些选项。 如果经过筛选的删除留下了某些项,即使在 WdDeleteOptions 中将 deleteRootFolder 设置为 true,也会保留根文件夹,因为只有在文件夹为空时才会删除该文件夹。

要求

另请参阅

最后修改于 2026年10月6日