IVssCreateExpressWriterMetadata::AddExcludeFiles 方法 (vswriter.h)

排除 (指定文件) 的文件集,否则在备份快速编写器的组件时可能会隐式包含这些文件集。

语法

HRESULT AddExcludeFiles(
  [in] LPCWSTR wszPath,
  [in] LPCWSTR wszFilespec,
  [in] bool    bRecursive
);

参数

[in] wszPath

指向以 null 结尾的宽字符串的指针,该字符串包含要排除文件的根目录。

路径可以包含环境变量 (例如 %SystemRoot%) 但不能包含通配符。

不要求路径以反斜杠 (\) 结尾。 由应用程序来检索此信息以检查。

[in] wszFilespec

指向以 null 结尾的宽字符串的指针,其中包含要排除的文件的文件规范。

文件规范不能包含目录规范 (例如,没有反斜杠) 但可以包含 ? 和 * 通配符。

[in] bRecursive

一个布尔值,指定 wszPath 参数指定的路径是仅标识单个目录,还是指示要以递归方式遍历的目录层次结构。 如果路径被视为要递归的目录层次结构,则应将此参数设置为 true ,否则应设置为 false

有关遍历已装载文件夹的信息,请参阅 使用装载的文件夹和重新分析点

返回值

下面是此方法的有效返回代码。

含义
S_OK
操作成功。
E_INVALIDARG
其中一个参数值无效。
E_OUTOFMEMORY
调用方内存不足或其他系统资源。
VSS_E_INVALID_XML_DOCUMENT
XML 文档无效。 有关详细信息,请查看事件日志。 有关详细信息,请参阅 VSS 下的事件和错误处理
VSS_E_UNEXPECTED
意外错误。 错误代码记录在错误日志文件中。 有关详细信息,请参阅 VSS 下的事件和错误处理

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP: 在 Windows Server 2008 R2 和 Windows 7 之前,不支持此值。 改用E_UNEXPECTED。

注解

Express 编写器仅支持本地资源-文件集,其绝对路径以有效的本地卷规范开头,并且不能是映射的网络驱动器。 因此,在解析任何环境变量后, (wszPath) 到 AddExcludeFiles) (的路径输入必须采用此格式。 例如,通常可以方便地定义组件以包括指定目录中的所有文件,然后使用 AddExcludeFiles 显式删除某些文件 (例如,从备份) 临时文件。

有关排除文件的详细信息,请参阅 排除文件列表规范

要求

要求
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 vswriter.h (包括 Vss.h、VsWriter.h)
Library VssApi.lib

另请参阅

IVssCreateExpressWriterMetadata

IVssCreateExpressWriterMetadata::AddComponent