Метод 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, содержащая разделенный запятыми список смещения файлов и длины, указывающие диапазон поддержки целевого файла (расположения, в которые должны быть восстановлены разделы исходного файла).

Число и длина диапазонов поддержки целевого файла должны соответствовать числу и размеру диапазонов поддержки исходных файлов.

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

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

Значение Значение
S_OK
Элемент успешно задан.
E_INVALIDARG
Одно из значений параметров недопустимо.
E_OUTOFMEMORY
Вызывающий объект не хватает памяти или других системных ресурсов.
VSS_E_BAD_STATE
Этот метод не был вызван средством записи или, если вызывается средством записи, он либо не был вызван во время операции восстановления, либо был вызван при обработке события 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

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

IVssComponent

IVssComponent::GetDirectedTarget

IVssComponent::GetDirectedTargetCount