Share via

Метод IVssFileShareSnapshotProvider::D eleteSnapshots (vsprov.h)

  • Статья

Удаляет определенные моментальные снимки или все моментальные снимки в указанном наборе snapshot.

Синтаксис

HRESULT DeleteSnapshots(
  [in]  VSS_ID          SourceObjectId,
  [in]  VSS_OBJECT_TYPE eSourceObjectType,
  [in]  BOOL            bForceDelete,
  [out] LONG            *plDeletedSnapshots,
  [out] VSS_ID          *pNondeletedSnapshotID
);

Параметры

[in] SourceObjectId

Идентификатор теневой копии или набора теневого копирования, который требуется удалить.

[in] eSourceObjectType

Тип удаляемого объекта. Этот параметр имеет значение VSS_OBJECT_SNAPSHOT или VSS_OBJECT_SNAPSHOT_SET.

[in] bForceDelete

Если этот параметр имеет значение TRUE, поставщик сделает все возможное, чтобы удалить теневую копию или теневые копии в наборе теневого копирования. Если он имеет значение FALSE, никаких дополнительных усилий не будет предпринят.

[out] plDeletedSnapshots

Указатель на переменную, получающую количество удаленных теневых копий.

[out] pNondeletedSnapshotID

При возникновении ошибки этот параметр получает указатель на идентификатор первой теневой копии, которую не удалось удалить. В противном случае он указывает на GUID_NULL.

Возвращаемое значение

Ниже приведены допустимые коды возврата для этого метода.

Значение Значение
S_OK
 Теневые копии успешно удалены.
E_ACCESSDENIED
 Вызывающий объект не имеет достаточных прав на резервное копирование или не является администратором.
E_INVALIDARG
 Одно из значений параметра является недопустимым.
E_OUTOFMEMORY
 Вызывающий объект не имеет памяти или других системных ресурсов.
VSS_E_OBJECT_NOT_FOUND
 Указанные теневые копии не найдены.
VSS_E_PROVIDER_VETO
 Ошибка поставщика. Поставщик зарегистрировал ошибку в журнале событий. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS.

Комментарии

Координатор VSS вызывает этот метод в рамках процесса автоматического выпуска snapshot. Метод также вызывается в ответ на операции удаления, управляемые инициатором запроса.

Требования

Требование Значение
Минимальная версия клиента Windows 8.1 [только классические приложения]
Минимальная версия сервера Windows Server 2012 R2 [только классические приложения]
Целевая платформа Windows
Header vsprov.h
Библиотека VssApi.lib

См. также раздел

IVssFileShareSnapshotProvider