通过

IVssCreateExpressWriterMetadata：：AddFilesToFileGroup 方法 (vswriter.h)

  • 项目

将 (指定文件集或) 的文件集添加到快速编写器的指定文件组组件。

语法

HRESULT AddFilesToFileGroup(
  [in] LPCWSTR wszLogicalPath,
  [in] LPCWSTR wszGroupName,
  [in] LPCWSTR wszPath,
  [in] LPCWSTR wszFilespec,
  [in] bool    bRecursive,
  [in] LPCWSTR wszAlternateLocation,
  [in] DWORD   dwBackupTypeMask
);

参数

[in] wszLogicalPath

指向以 null 结尾的宽字符串的指针，该字符串包含逻辑路径 (可为 NULL ，) 要向其添加文件的组件。 有关详细信息，请参阅 组件的逻辑路径。

[in] wszGroupName

指向以 null 结尾的宽字符串的指针，该字符串包含文件组组件的名称。 此组件的类型必须VSS_CT_FILEGROUP;否则，该方法将返回错误。

[in] wszPath

指向以 null 结尾的宽字符串的指针，该字符串包含要添加的文件的默认根目录。

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

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

[in] wszFilespec

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

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

[in] bRecursive

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

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

[in] wszAlternateLocation

此参数是保留的，必须为 NULL。

[in] dwBackupTypeMask

VSS_FILE_SPEC_BACKUP_TYPE枚举值的位掩码，指示编写器是否应评估文件以参与某种类型的备份操作。

此参数不能包含 VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED、 VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED或 VSS_FSBT_LOG_BACKUP_REQUIRED。

此参数的默认值为 (VSS_FSBT_ALL_BACKUP_REQUIRED |VSS_FSBT_ALL_SNAPSHOT_REQUIRED) 。

返回值

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

值 含义
S_OK
 操作成功。
E_INVALIDARG
 其中一个参数值无效，或者调用方尝试将文件组文件添加到非文件组组件。
E_OUTOFMEMORY
 调用方内存或其他系统资源不足。
VSS_E_INVALID_XML_DOCUMENT
 XML 文档无效。 有关详细信息，请查看事件日志。 有关详细信息，请参阅 VSS 下的事件和错误处理。
VSS_E_OBJECT_NOT_FOUND
 指定的组件不存在。
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
标头 vswriter.h (包括 Vss.h、VsWriter.h)
Library VssApi.lib

另请参阅

IVssCreateExpressWriterMetadata