Метод 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
 Не удалось выполнить операцию приостановки набора теневых копий, так как сигнатура диска MBR, идентификатор диска GPT или идентификатор раздела GPT одного или нескольких целевых LUN не могут быть возвращены к исходным 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 с пакетом обновления 1 (SP1) [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header vsbackup.h (включая VsBackup.h, Vss.h, VsWriter.h)