Метод IVssBackupComponents::D eleteSnapshots (vsbackup.h)
Метод DeleteSnapshots удаляет одну или несколько теневых копий или набор теневого копирования.
Синтаксис
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.
Возвращаемое значение
Ниже приведены допустимые коды возврата для этого метода.
Значение | Значение |
---|---|
|
Теневые копии успешно удалены. |
|
Вызывающий объект не имеет достаточных прав на резервное копирование или не является администратором. |
|
Одно из значений параметра является недопустимым. |
|
Вызывающий объект не имеет памяти или других системных ресурсов. |
|
Непредвиденная ошибка. Код ошибки регистрируется в файле журнала ошибок. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows Server 2008 R2 и Windows 7. вместо этого используется E_UNEXPECTED. |
|
Указанная теневая копия не существует. |
|
Ожидаемая ошибка поставщика. Поставщик зарегистрировал ошибку в журнале событий. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS. |
|
Непредвиденная ошибка поставщика. Код ошибки регистрируется в журнале ошибок. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS. |
Комментарии
Несколько теневых копий в наборе теневого копирования удаляются последовательно. Если во время одного из этих отдельных удалений возникает ошибка, deleteSnapshots возвращается немедленно; Не будет предпринята попытка удалить все оставшиеся теневые копии. VSS_ID отмененной теневой копии возвращается в pNondeletedSnapshotID.
Инициатор запроса отвечает за сериализацию операции удаления теневого копирования.
Во время резервного копирования теневые копии автоматически освобождаются сразу после выпуска экземпляра IVssBackupComponents . В этом случае нет необходимости явно удалять теневые копии.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows XP [только классические приложения] |
Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
Целевая платформа | Windows |
Header | vsbackup.h (включая VsBackup.h, Vss.h, VsWriter.h) |
Библиотека | VssApi.lib |