IVssWMFiledesc：：GetPath 方法 (vswriter.h)

  • 项目

GetPath 方法获取远程文件共享的完全限定目录路径或 UNC 路径，以获取当前 IVssWMFiledesc 对象中描述的文件列表。

查询方法使用此路径和文件规范返回当前 IVssWMFiledesc 对象。

语法

HRESULT GetPath(
  [out] BSTR *pbstrPath
);

参数

[out] pbstrPath

调用方分配的变量的地址，该变量接收以 NULL 结尾的宽字符串，该字符串指定远程文件共享目录的完全限定目录路径或 UNC 路径。

路径可以是长文件名或短文件名，并且可以使用前缀“\？”。 有关详细信息，请参阅命名文件。

此方法的用户需要检查，以确定此路径是否以反斜杠 (“”) 结尾。

返回值

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

值 含义
S_OK
 已成功返回路径信息。
E_INVALIDARG
 其中一个参数值无效。
E_OUTOFMEMORY
 调用方内存或其他系统资源不足。
VSS_E_INVALID_XML_DOCUMENT
 XML 文档无效。 有关详细信息，请查看事件日志。 有关详细信息，请参阅 VSS 下的事件和错误处理。
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 之前不支持远程文件共享。

调用方必须调用 SysFreeString 才能释放 pbstrPath 参数持有的内存。

要求

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

另请参阅

IVssWMFiledesc