Поделиться через


Метод IVssBackupComponents::D oSnapshotSet (vsbackup.h)

Одновременно фиксирует все теневые копии в этом наборе.

Синтаксис

HRESULT DoSnapshotSet(
  [out] IVssAsync **ppAsync
);

Параметры

[out] ppAsync

Вдвойне косвенный указатель на требуемый асинхронный интерфейс IVssAsync . Он используется для запроса состояния выполнения метода и получения окончательного кода ошибки.

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

Ниже приведены допустимые коды возврата для этого метода. Эти коды ошибок могут быть возвращены из этого метода или метода QueryStatus в интерфейсе IVssAsync , возвращенном в параметре ppAsync .

Значение Значение
S_OK
Успешно возвращен указатель на экземпляр интерфейса IVssAsync . Допустимые значения, возвращаемые параметром pHrResult, см. в разделе IVssAsync::QueryStatus.
E_ACCESSDENIED
Вызывающий объект не имеет достаточных прав на резервное копирование или не является администратором.
E_INVALIDARG
ppAsync не указывает на допустимый указатель; то есть имеет значение NULL.
E_OUTOFMEMORY
Вызывающий объект не имеет памяти или других системных ресурсов.
VSS_E_BAD_STATE
Объект компонентов резервной копии не инициализирован или предварительные вызовы для заданного контекста теневого копирования не были выполнены до вызова DoSnapshotSet.
VSS_E_INSUFFICIENT_STORAGE
Системе или поставщику недостаточно места для хранения. По возможности удалите старые или ненужные теневые копии и повторите попытку. Этот код ошибки возвращается только с помощью метода QueryStatus в интерфейсе IVssAsync , возвращенном в параметре ppAsync .
VSS_E_FLUSH_WRITES_TIMEOUT
Системе не удалось очистить операции записи ввода-вывода. Это может быть временной проблемой. Рекомендуется подождать десять минут и повторить попытку до трех раз.
VSS_E_HOLD_WRITES_TIMEOUT
Системе не удалось сохранить операции записи ввода-вывода. Это может быть временной проблемой. Рекомендуется подождать десять минут и повторить попытку до трех раз.
VSS_E_NESTED_VOLUME_LIMIT
Указанный том слишком глубоко вложен для участия в операции VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Этот код возврата не поддерживается.

VSS_E_PROVIDER_VETO
Поставщику не удалось выполнить запрос в это время. Это может быть временной проблемой. Рекомендуется подождать десять минут и повторить попытку до трех раз. Этот код ошибки возвращается только с помощью метода QueryStatus в интерфейсе IVssAsync , возвращенном в параметре ppAsync .
VSS_E_REBOOT_REQUIRED
Поставщик обнаружил ошибку, из-за которой пользователь должен перезагрузить компьютер.

Windows Server 2003 и Windows XP: Это значение не поддерживается.

VSS_E_TRANSACTION_FREEZE_TIMEOUT
Системе не удалось заморозить координатор распределенных транзакций (DTC) или диспетчер транзакций ядра (KTM).

Windows Server 2003 и Windows XP: Это значение не поддерживается.

VSS_E_TRANSACTION_THAW_TIMEOUT
Системе не удалось разморозить координатор распределенных транзакций (DTC) или диспетчер транзакций ядра (KTM).

Windows Server 2003 и Windows XP: Это значение не поддерживается.

VSS_E_UNEXPECTED
Непредвиденная ошибка. Код ошибки регистрируется в файле журнала ошибок. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows Server 2008 R2 и Windows 7. вместо этого используется E_UNEXPECTED.

VSS_E_UNEXPECTED_PROVIDER_ERROR
Поставщик вернул непредвиденный код ошибки. Это может быть временной проблемой. Рекомендуется подождать десять минут и повторить попытку до трех раз. Этот код ошибки возвращается только с помощью метода QueryStatus в интерфейсе IVssAsync , возвращенном в параметре ppAsync .

Комментарии

Вызывающий объект отвечает за освобождение интерфейса IVssAsync .

Этот метод не может быть вызван для виртуального жесткого диска (VHD), вложенного в другой виртуальный жесткий диск.

Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Виртуальные жесткие диски не поддерживаются.

Сведения об использовании IVssBackupComponents::D oSnapshotSet для создания стандартной теневой копии резервной копии см. в разделах Обзор задач предварительного резервного копирования и Простое создание теневого копирования для резервного копирования. Сведения об использовании метода в разных контекстах VSS см. в разделе Сведения о реализации для создания теневых копий.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header vsbackup.h (включая VsBackup.h, Vss.h, VsWriter.h)
Библиотека VssApi.lib

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

IVssAsync

IVssBackupComponents

IVssBackupComponents::AddComponent

IVssBackupComponents::AddToSnapshotSet

IVssBackupComponents::P repareForBackup

IVssBackupComponents::StartSnapshotSet