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

Статья
03/03/2024

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

Синтаксис

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 .

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

Требования

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