通过

IVssFileShareSnapshotProvider：：BeginPrepareSnapshot 方法 (vsprov.h)

  • 项目

VSS 对添加到卷影副本集的每个卷影副本调用此方法。

语法

HRESULT BeginPrepareSnapshot(
  [in] VSS_ID   SnapshotSetId,
  [in] VSS_ID   SnapshotId,
  [in] VSS_PWSZ pwszSharePath,
  [in] LONG     lNewContext,
  [in] VSS_ID   ProviderId
);

参数

[in] SnapshotSetId

卷影复制集标识符。

[in] SnapshotId

要创建的卷影副本的标识符。

[in] pwszSharePath

文件共享路径。

[in] lNewContext

卷影复制集的上下文。 此上下文由 _VSS_VOLUME_SNAPSHOT_ATTRIBUTES 值的位掩码组成。

[in] ProviderId

提供程序 ID。

返回值

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

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

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 在 Windows Server 2008 R2 和 Windows 7 之前，不支持此值。 改用E_UNEXPECTED。

要求

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

另请参阅

IVssFileShareSnapshotProvider