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

Метод 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.

Комментарии

Одновременно можно импортировать только одну теневые копии.

Инициатор запроса отвечает за сериализацию операции импорта теневого копирования.

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

Дополнительные сведения об импорте теневых копий см. в статье Импорт переносимых теневых томов.

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

Примечание Если импорт теневого копирования завершается сбоем, служба теневого копирования томов не будет самостоятельно очищать 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

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

IVssAsync

IVssAsync::QueryStatus

IVssBackupComponents

IVssBackupComponents::ExposeSnapshot

IVssBackupComponents::InitializeForBackup