IVssCreateWriterMetadata：：AddDatabaseFiles 方法 (vswriter.h)

  • 项目

AddDatabaseFiles 方法指示 (组成要备份的数据库组件的指定文件) 文件集。

语法

HRESULT AddDatabaseFiles(
  [in] LPCWSTR wszLogicalPath,
  [in] LPCWSTR wszDatabaseName,
  [in] LPCWSTR wszPath,
  [in] LPCWSTR wszFilespec,
  [in] DWORD   dwBackupTypeMask
);

参数

[in] wszLogicalPath

指向以 null 结尾的宽字符串的指针，该字符串包含要向其添加数据库的组件的逻辑路径。

有关详细信息，请参阅组件的逻辑路径。

逻辑路径不是必需的，可以为 NULL。

[in] wszDatabaseName

指向包含数据库名称的 以 null 结尾的宽字符串的指针。

此名称是必需的，并且必须与要向其添加数据库的组件的名称匹配。

[in] wszPath

指向以 null 结尾的宽字符串的指针，该字符串包含包含数据库文件的目录的路径。

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

支持 UNC 路径。

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

[in] wszFilespec

指向以 null 结尾的宽字符串的指针，该字符串包含一个或多个与数据库关联的文件的文件规范。

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

[in] dwBackupTypeMask

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

此参数的默认值为 (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 Vista、Windows Server 2008、Windows XP 和 Windows Server 2003： 在Windows 8和Windows Server 2012之前，不支持远程文件共享。 编写器仅支持本地资源-文件集，其绝对路径以有效的本地卷规范开头，不能是映射的网络驱动器。 因此，在解析任何环境变量) 后， (wszPath () 到 AddDatabaseFiles 的路径输入必须采用此格式。

对于特定数据库，可以多次调用此方法。 当数据库位于存储在单独卷上的文件时，这与 Microsoft SQL Server一样。

wszLogicalPath 和 wszDatabaseName 参数的值应与之前使用 IVssCreateWriterMetadata：：AddComponent 方法添加的数据库组件之一匹配。

要求

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

另请参阅

IVssCreateWriterMetadata

IVssCreateWriterMetadata：：AddComponent