IVssBackupComponentsEx2：：BreakSnapshotSetEx 方法 (vsbackup.h)

  • 项目

根据请求者指定的选项中断卷影副本集。

语法

HRESULT BreakSnapshotSetEx(
  [in]  VSS_ID    SnapshotSetID,
  [in]  DWORD     dwBreakFlags,
  [out] IVssAsync **ppAsync
);

参数

[in] SnapshotSetID

卷影副本集标识符。

[in] dwBreakFlags

_VSS_HARDWARE_OPTIONS标志的位掩码，用于指定如何破坏卷影副本集。

[out] ppAsync

指向接收 IVssAsync 接口指针的变量的指针，该指针可用于检索卷影复制集中断操作的状态。 中断操作完成后，必须为此接口指针调用 IUnknown：：Release 方法。

返回值

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

值 含义
S_OK
0x00000000L
 已成功破坏卷影副本集。
E_ACCESSDENIED
0x80070005L
 调用方没有足够的权限或不是管理员。
E_INVALIDARG
0x80070057L
 其中一个参数值无效。
E_OUTOFMEMORY
0x8007000EL
 调用方内存或其他系统资源不足。
VSS_E_BREAK_REVERT_ID_FAILED
0x800423F6L
 卷影复制集中断操作失败，因为无法将一个或多个目标 LUN 的 MBR 磁盘签名、GPT 磁盘标识符或 GPT 分区标识符还原到原始 LUN。 如果计算机上没有屏蔽一个或多个原始 LUN，则中断操作将导致签名冲突。
VSS_E_OBJECT_NOT_FOUND
0x80042308L
 指定的卷影副本不存在。
VSS_E_PROVIDER_VETO
0x80042306L
 卷影副本由软件提供商创建，无法损坏。
VSS_E_UNEXPECTED
 意外错误。 错误代码记录在错误日志文件中。 有关详细信息，请参阅 VSS 下的事件和错误处理。

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

注解

BreakSnapshotSetEx 类似于 IVssBackupComponents：：BreakSnapshotSet 方法，只不过它具有用于查询状态和指定如何破坏卷影副本集的额外参数。

与 BreakSnapshotSet 一样， BreakSnapshotSetEx 只能用于由硬件卷影复制提供程序创建的卷影副本。

此方法返回后，卷影副本卷仍然是卷，但它不再是卷影副本。 有关详细信息，请参阅 中断卷影副本。

要求

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