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

Статья
08/27/2023

Метод ImportSnapshots импортирует теневые копии, перенесенные с другого компьютера.

Примечание Этот метод поддерживается только в операционных системах Windows Server и для поставщиков оборудования службы теневого копирования томов.

Синтаксис

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

Параметры

[out] ppAsync

Вдвойне косвенный указатель на объект IVssAsync , содержащий импортированные данные о состоянии теневой копии.

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

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

Значение	Значение
S_OK	Успешно возвращен указатель на экземпляр интерфейса IVssAsync . Коды ошибок, возвращаемые в параметре pHrResult, см. на справочной странице для IVssAsync::QueryStatus.
E_ACCESSDENIED	Вызывающий объект не имеет достаточных прав на резервное копирование или не является администратором.
E_INVALIDARG	Параметр ppAsync не указывает на допустимый указатель; то есть имеет значение NULL.
E_OUTOFMEMORY	Вызывающий объект не имеет памяти или других системных ресурсов.
VSS_E_BAD_STATE	Объект компонента резервной копии не инициализирован, этот метод был вызван во время операции восстановления или не был вызван из правильной последовательности.
VSS_E_UNEXPECTED	Непредвиденная ошибка. Код ошибки регистрируется в файле журнала ошибок. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS. Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows Server 2008 R2 и Windows 7. вместо этого используется E_UNEXPECTED.

Переносимые теневые копии в кластере: Дополнительные сведения об использовании переносимых теневых копий в кластере см. в статье Быстрое восстановление с использованием переносимых теневых томов. Переносимая теневая копия должна быть импортирована извне кластера при условии, что исходный том подключен в кластере.

Примечание Если импорт теневого копирования завершается сбоем, служба теневого копирования томов не будет самостоятельно очищать LUN. Инициатор запроса должен инициировать очистку LUN.

Требования

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