перечисление VSS_RESTORE_TARGET (vswriter.h)

Перечисление VSS_RESTORE_TARGET используется модулем записи во время восстановления, чтобы указать, как будут восстановлены все файлы, включенные в выбранный компонент, и все файлы в любом наборе компонентов, который он определяет. (Сведения о выборе компонентов см. в разделе Работа с возможностью выбора и логическими путями .)

Установка целевого объекта восстановления изменяет или переопределяет метод восстановления, заданный во время резервного копирования (см . VSS_RESTOREMETHOD_ENUM).

Синтаксис

typedef enum VSS_RESTORE_TARGET {
  VSS_RT_UNDEFINED = 0,
  VSS_RT_ORIGINAL,
  VSS_RT_ALTERNATE,
  VSS_RT_DIRECTED,
  VSS_RT_ORIGINAL_LOCATION
} ;

Константы

 
VSS_RT_UNDEFINED
Значение: 0
Целевой объект не определен.


Это значение указывает на ошибку со стороны модуля записи.

Это значение не поддерживается для экспресс-модулей записи.
VSS_RT_ORIGINAL
Это целевой объект восстановления по умолчанию.


Это значение указывает, что восстановление файлов, включенных в выбранный компонент (или набор компонентов).
определяется этим компонентом) должен выполняться в соответствии с исходным методом восстановления, указанным во время резервного копирования.
значение VSS_RESTOREMETHOD_ENUM .
VSS_RT_ALTERNATE
Файлы восстанавливаются в расположение, определенное по существующему альтернативному сопоставлению расположений.


Целевой объект восстановления должен быть установлен в VSS_RT_ALTERNATE только в том случае, если альтернативное расположение
Для всех файлов, управляемых выбранным компонентом или набором компонентов, заданы сопоставления.

Это значение не поддерживается для экспресс-модулей записи.
VSS_RT_DIRECTED
Используйте направленный нацеливание модуля записи во время восстановления для восстановления файла.


Направленное нацеливание позволяет модулю записи управлять тем, как находится файл, на основе файлов.
restored — указывает, сколько файлов необходимо восстановить и в какие файлы
Файл резервной копии необходимо восстановить.

Это значение не поддерживается для экспресс-модулей записи.
VSS_RT_ORIGINAL_LOCATION
Файлы восстанавливаются в расположении, в котором они находились во время резервного копирования, даже если исходные файлы
Метод восстановления, указанный во время резервного копирования, —
VSS_RME_RESTORE_TO_ALTERNATE_LOCATION.


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

Это значение не поддерживается для экспресс-модулей записи.

Комментарии

Целевой объект VSS_RT_UNDEFINED указывает на состояние ошибки.

Во время резервного копирования модули записи задают поведение восстановления по умолчанию, указывая метод восстановления (VSS_RESTOREMETHOD_ENUM), заданный с помощью IVssCreateWriterMetadata::SetRestoreMethod.

Если модуль записи явно не задает целевой объект восстановления компонента и любой набор компонентов, который он определяет, по умолчанию устанавливается значение VSS_RT_ORIGINAL.

Во время восстановления VSS_RESTORE_TARGET значение, отличное от VSS_RT_ORIGINAL , переопределяет значение первоначально указанного метода восстановления, указанного VSS_RESTOREMETHOD_ENUM и заданного IVssCreateWriterMetadata::SetRestoreMethod.

Только записи (используя IVssComponent::SetRestoreTarget) могут задавать целевой объект восстановления (VSS_RESTORE_TARGET) и изменять способ восстановления файлов, переопределяя метод восстановления.

Инициаторы запроса и записи могут получить доступ к текущему целевому объекту восстановления через IVssComponent::GetRestoreTarget.

Целевой объект восстановления VSS_RT_ORIGINAL не означает, что файлы должны быть восстановлены в исходном расположении, но необходимо учитывать первоначально указанный метод восстановления (VSS_RESTOREMETHOD_ENUM). Например, если модуль записи задает метод восстановления VSS_RME_RESTORE_TO_ALTERNATE_LOCATION для выбранного компонента и целевой объект восстановления VSS_RT_ORIGINAL, файлы должны быть восстановлены в альтернативном расположении, определенном модулем записи.

(В этом примере, если модуль записи не смог определить сопоставления альтернативных расположений, это ошибка записи, и инициатор запроса должен сообщить об этом.)

Целевой объект восстановления VSS_RT_ALTERNATE без определения альтернативного сопоставления расположения представляет собой ошибку записи, и инициатор запроса должен сообщить об этом.

Дополнительные сведения см. в разделе Расположения резервного копирования и восстановления по умолчанию .

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть vswriter.h

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

IVssComponent::GetRestoreTarget

IVssComponent::SetRestoreTarget

VSS_RESTOREMETHOD_ENUM