Метод IVssComponent::AddDirectedTarget (vswriter.h)
Метод AddDirectedTarget позволяет записи указывать во время восстановления, что при восстановлении файла его (исходный файл) следует перенаправить. Файл можно восстановить в новом расположении восстановления и (или) диапазонах данных, восстановленных в различных смещениях в расположении восстановления.
Этот метод может вызываться средством записи только во время операции восстановления.
Этот метод нельзя вызвать при обработке события BackupComplete (CVssWriter::OnBackupComplete) или BackupShutdown (CVssWriter::OnBackupShutdown).
Синтаксис
HRESULT AddDirectedTarget(
[in] LPCWSTR wszSourcePath,
[in] LPCWSTR wszSourceFilename,
[in] LPCWSTR wszSourceRangeList,
[in] LPCWSTR wszDestinationPath,
[in] LPCWSTR wszDestinationFilename,
[in] LPCWSTR wszDestinationRangeList
);
Параметры
[in] wszSourcePath
Строка расширенных символов, завершающаяся значением NULL, содержащая путь к каталогу во время восстановления, содержащего восстановленный файл (исходный файл). Этот путь должен совпадать или находиться под путем набора файлов, уже в компоненте (или один из его подкомпонентов, если компонент определяет набор компонентов).
[in] wszSourceFilename
Строка расширенных символов, завершающаяся значением NULL, содержащая имя файла (во время резервного копирования), которое будет переназначаться во время восстановления (исходный файл). Имя файла (wszSourceFilename) не может содержать подстановочные знаки (* или ?) и должно соответствовать спецификации файла набора файлов, содержащего исходный путь (wszSourcePath).
[in] wszSourceRangeList
Строка расширенных символов, завершающаяся значением NULL, содержащая разделенный запятыми список смещения файлов и длины, указывающие диапазон поддержки исходного файла (разделы файла для фактического восстановления).
Число и длина диапазонов поддержки исходного файла должны соответствовать числу и размеру диапазонов поддержки файлов назначения.
[in] wszDestinationPath
Строка расширенных символов, завершающаяся значением NULL, содержащая путь, к которому данные исходного файла будут переназначаться во время восстановления.
[in] wszDestinationFilename
Строка расширенных символов, завершающаяся значением NULL, содержащая имя файла, с которыми данные исходного файла будут переназначаться во время восстановления. Имя файла (wszDestinationFilename) не может содержать подстановочные знаки (* или ?).
[in] wszDestinationRangeList
Строка расширенных символов, завершающаяся значением NULL, содержащая разделенный запятыми список смещения файлов и длины, указывающие диапазон поддержки целевого файла (расположения, в которые должны быть восстановлены разделы исходного файла).
Число и длина диапазонов поддержки целевого файла должны соответствовать числу и размеру диапазонов поддержки исходных файлов.
Возвращаемое значение
Ниже приведены допустимые коды возврата для этого метода.
| Значение | Значение |
|---|---|
|
Элемент успешно задан. |
|
Одно из значений параметров недопустимо. |
|
Вызывающий объект не хватает памяти или других системных ресурсов. |
|
Этот метод не был вызван средством записи или, если вызывается средством записи, он либо не был вызван во время операции восстановления, либо был вызван при обработке события BackupComplete или BackupShutdown . |
Комментарии
Только модуль записи может вызывать AddDirectedTarget и только во время операций восстановления.
Инициатор запроса будет использовать направленную целевую информацию, хранящуюся в документе компонентов резервного копирования, только если целевой объект восстановления VSS_RT_DIRECTED.
Метод AddDirectedTarget может применяться к любому файлу, управляемому текущим компонентом, или, если компонент определяет набор компонентов, в любом из его неизбираемых подкомпонентов.
Спецификации исходного и целевого файлов могут указывать на один и тот же файл. Это позволит переназначить сам файл во время восстановления.
Синтаксис списка диапазонов (wszSourceRanges и wszDestinationRanges) — это список разделенных запятыми списка смещения формы offset1:length1, offset2:length2, где каждое смещение и длина — 64-битовое целое число, указывающее смещение и длину байтов соответственно. Смещение и длина могут быть выражены как шестнадцатеричные или десятичные значения.
Количество записей и их размеров должно совпадать в аргументах исходного и целевого диапазонов.
AddDirectedTarget может использовать в качестве исходного файла любой файл, уже управляемый компонентом, или один из его подкомпонентов, если компонент определяет набор компонентов.
Частичные файлы могут быть добавлены в качестве целевых объектов, если резервные копии частичных диапазонов файлов соответствуют целевым диапазонам целевых источников (см. раздел IVssComponent::AddPartialFile). Это позволит повторно отображать частичные файлы во время восстановления.
В этом случае инициатор запроса получает направленные целевые сведения путем вызова метода IVssComponent::GetDirectedTarget и использует его для реализации повторного сопоставления резервных данных во время восстановления.
Требования
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | vswriter.h (include Vss.h, VsWriter.h) |
| Библиотека | VssApi.lib |