通过

IVssFileShareSnapshotProvider：：GetSnapshotProperties 方法 (vsprov.h)

  • 项目

获取文件共享快照的VSS_SNAPSHOT_PROP结构。

语法

HRESULT GetSnapshotProperties(
  [in]  VSS_ID            SnapshotId,
  [out] VSS_SNAPSHOT_PROP *pProp
);

参数

[in] SnapshotId

卷影复制标识符。

[out] pProp

接收卷影复制属性的调用方分配 VSS_SNAPSHOT_PROP 结构的地址。 提供程序负责设置此结构的成员。 除 m_pwszExposedName 和 m_pwszExposedPath外，所有成员都是必需的，提供程序可以设置为 NULL。 提供程序为它在 结构中设置的所有字符串成员分配内存。 当不再需要结构时，调用方负责通过调用 VssFreeSnapshotProperties 函数来释放这些字符串。

返回值

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

值 含义
S_OK
 已成功返回请求的信息。
E_ACCESSDENIED
 调用方没有足够的备份权限或不是管理员。
E_INVALIDARG
 其中一个参数值无效。
E_OUTOFMEMORY
 调用方内存不足或其他系统资源。
VSS_E_OBJECT_NOT_FOUND
 找不到指定的卷。
VSS_E_PROVIDER_VETO
 提供程序错误。 提供程序在事件日志中记录了错误。 有关详细信息，请参阅 VSS 下的事件和错误处理。
VSS_E_UNEXPECTED
 意外错误。 错误代码记录在错误日志文件中。 有关详细信息，请参阅 VSS 下的事件和错误处理。

注解

调用方在调用 GetSnapshotProperties 方法之前，应将 VSS_SNAPSHOT_PROP 结构的内容设置为零。

提供程序负责分配和释放 VSS_SNAPSHOT_PROP 结构中的字符串。

VSS 协调器在创建快照的 PostSnapshot 阶段调用此方法，以便检索文件共享快照) (UNC 路径快照访问路径。 协调器在 PreFinalCommitSnapshots 之后和在编写器中调用 PostSnapshot 之前调用此方法。

要求

要求 值
最低受支持的客户端 Windows 8.1 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 R2 [仅限桌面应用]
目标平台 Windows
标头 vsprov.h
Library VssApi.lib

另请参阅

IVssFileShareSnapshotProvider