IVssCreateWriterMetadataEx：：AddExcludeFilesFromSnapshot 方法 (vswriter.h)

报告将在创建卷影副本时由编写器显式排除的任何文件集。

调用此方法不会导致排除文件。编写器负责从其 CVssWriter：：OnPostSnapshot 方法中的卷影副本中删除文件。

语法

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

[in] wszPath

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

该目录可以是 VSS 计算机上的本地目录，也可以是远程文件服务器上的文件共享目录。

支持 UNC 路径。

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

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

[in] wszFilespec

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

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

[in] bRecursive

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

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

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

值	含义
S_OK 0x00000000L	操作成功。
E_INVALIDARG 0x80070057L	其中一个参数值无效。
E_OUTOFMEMORY 0x8007000EL	调用方内存不足或其他系统资源。
VSS_E_INVALID_XML_DOCUMENT 0x80042311L	XML 文档无效。有关详细信息，请查看事件日志。有关详细信息，请参阅 VSS 下的事件和错误处理。
VSS_E_NOT_SUPPORTED 0x8004232FL	快速编写器不支持此方法。
VSS_E_UNEXPECTED	意外错误。错误代码记录在错误日志文件中。有关详细信息，请参阅 VSS 下的事件和错误处理。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP：在 Windows Server 2008 R2 和 Windows 7 之前，不支持此值。改用E_UNEXPECTED。

Windows 7、Windows Server 2008 R2、Windows Vista、Windows Server 2008、Windows XP 和 Windows Server 2003： 在Windows 8和Windows Server 2012之前，不支持远程文件共享。

AddExcludeFilesFromSnapshot 方法的使用是可选的。编写器应仅对卷影复制操作之间发生重大更改的大型文件使用此方法。

此方法不能替代 IVssCreateWriterMetadata：：AddExcludeFiles 方法。编写器应继续使用 AddExcludeFiles 方法来报告从备份中排除的文件集。

调用方负责调用 IUnknown：：Release 方法来释放返回的 IVssWMFiledesc 对象的资源。