IVssWMComponent::GetDatabaseFile 方法 (vsbackup.h)
GetDatabaseFile 方法获取包含指定数据库备份组件文件相关信息的 IVssWMFiledesc 对象。
语法
HRESULT GetDatabaseFile(
[in] UINT iDBFile,
[out] IVssWMFiledesc **ppFiledesc
);
参数
[in] iDBFile
介于 0 和 n-1 之间的偏移量,其中 n 是由 IVssWMComponent::GetComponentInfo 返回的 VSS_COMPONENTINFO 对象的 cDatabases 成员指定的数据库文件数。
[out] ppFiledesc
指向包含返回的文件描述符信息的 IVssWMFiledesc 对象的双重间接指针。
返回值
下面是此方法的有效返回代码。
值 | 含义 |
---|---|
|
已成功返回指向 IVssWMFiledesc 接口实例的指针。 |
|
其中一个参数值无效。 |
|
调用方内存或其他系统资源不足。 |
|
XML 文档无效。 有关详细信息,请查看事件日志。 有关详细信息,请参阅 VSS 下的事件和错误处理。 |
|
指定的数据库文件不存在。 |
|
意外错误。 错误代码记录在错误日志文件中。 有关详细信息,请参阅 VSS 下的事件和错误处理。
Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP: 在 Windows Server 2008 R2 和 Windows 7 之前不支持此值。 改用E_UNEXPECTED。 |
注解
调用方负责调用 IUnknown::Release 以释放返回的 IVssWMFiledesc 对象持有的系统资源。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | vsbackup.h (包括 VsBackup.h、Vss.h、VsWriter.h) |
Library | VssApi.lib |