IVssWMComponent::GetFile 方法 (vsbackup.h)

GetFile 方法获取与文件组关联的文件描述符。

语法

HRESULT GetFile(
  [in]  UINT           iFile,
  [out] IVssWMFiledesc **ppFiledesc
);

参数

[in] iFile

介于 0 和 n-1 之间的偏移量,其中 n 是由 IVssWMComponent::GetComponentInfo 返回的 VSS_COMPONENTINFO 对象的 cFileCount 成员指定的文件组中的文件数。

[out] ppFiledesc

指向包含返回的文件描述符信息的 IVssWMFiledesc 对象的双间接指针。

返回值

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

含义
S_OK
已成功返回指向 IVssWMFiledesc 接口实例的指针。
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。

注解

调用方负责调用 IUnknown::Release 以释放返回的 IVssWMFiledesc 对象保留的系统资源。

要求

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

另请参阅

IVssWMComponent