IVssCreateWriterMetadata：：AddDatabaseLogFiles 方法 (vswriter.h)
AddDatabaseLogFiles 方法指示与要备份的数据库关联的日志文件及其位置。
语法
HRESULT AddDatabaseLogFiles(
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszDatabaseName,
[in] LPCWSTR wszPath,
[in] LPCWSTR wszFilespec,
[in] DWORD dwBackupTypeMask
);
参数
[in] wszLogicalPath
指向以 null 结尾的宽字符串的指针，该字符串包含将向其添加日志文件的数据库组件的逻辑路径。
有关详细信息，请参阅 组件的逻辑路径。
逻辑路径不是必需的，可以为 NULL。
[in] wszDatabaseName
指向以 null 结尾的宽字符串的指针，该字符串包含与日志文件关联的数据库组件的名称。 必须VSS_CT_DATABASE此组件的类型;否则，该方法将返回错误。
[in] wszPath
指向以 null 结尾的宽字符串的指针，该字符串包含包含日志文件的目录的路径。
目录可以是 VSS 计算机上的本地目录，也可以是远程文件服务器上的文件共享目录。
支持 UNC 路径。
路径可以包含环境变量 (例如 %SystemRoot%) ，但不能包含通配符。
不要求路径以反斜杠 (“”) 结尾。 由应用程序来检索此信息以检查。
[in] wszFilespec
指向以 null 结尾的宽字符串的指针，该字符串包含与数据库关联的日志文件 () 的文件规范。
文件规范不能包含目录规范 (例如，没有反斜杠) 但可以包含 ？ 和 * 通配符。
[in] dwBackupTypeMask
位掩码 (或按位 OR) VSS_FILE_SPEC_BACKUP_TYPE 枚举值，以指示编写器是否应评估文件以参与某种类型的备份操作。
此参数的默认值为 (VSS_FSBT_ALL_BACKUP_REQUIRED |VSS_FSBT_ALL_SNAPSHOT_REQUIRED) 。
返回值
下面是此方法的有效返回代码。
| 值 | 含义 |
|---|---|
|
操作成功。 |
|
其中一个参数值无效，或者调用方尝试将数据库文件添加到非数据库组件。 |
|
调用方内存或其他系统资源不足。 |
|
XML 文档无效。 有关详细信息，请查看事件日志。 有关详细信息，请参阅 VSS 下的事件和错误处理。 |
|
指定的组件不存在。 |
|
意外错误。 错误代码记录在错误日志文件中。 有关详细信息，请参阅 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) 到 AddDatabaseLogFi (les 的路径输入) 必须采用此格式。
对于特定数据库组件，可以多次调用此方法，当多个日志文件存储在单独的卷上时，可能需要此方法。
wszLogicalPath 和 wszDatabaseName 参数的值应与之前使用 IVssCreateWriterMetadata：：AddComponent 方法添加的数据库组件之一的值匹配。
要求
| 最低受支持的客户端 | Windows XP [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | vswriter.h (包括 Vss.h、VsWriter.h) |
| Library | VssApi.lib |