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

Статья
03/08/2023

Метод SetRangesFilePath используется, когда для операции с частичным файлом требуется файл диапазонов, и этот файл был восстановлен в расположение, отличное от исходного.

Синтаксис

HRESULT SetRangesFilePath(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE ct,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] UINT               iPartialFile,
  [in] LPCWSTR            wszRangesFile
);

Параметры

[in] writerId

Глобальный уникальный идентификатор (GUID) класса записи, содержащего файлы, участвующие в операции с частичным файлом.

[in] ct

Определяет тип компонента. Возможные возвращаемые значения см. в VSS_COMPONENT_TYPE .

[in] wszLogicalPath

Строка расширенных символов со значением NULL, содержащая логический путь компонента, содержащего файлы, участвующие в операции с частичным файлом.

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

Значение строки, содержащей используемый здесь логический путь, должно совпадать с значением, которое использовалось при добавлении компонента в резервный набор с помощью IVssBackupComponents::AddComponent.

Логический путь может иметь значение NULL.

Нет ограничений на символы, которые могут отображаться в логическом пути, отличном от NULL .

[in] wszComponentName

Строка расширенных символов со значением NULL, содержащая имя компонента, содержащего файлы, участвующие в операции с частичным файлом.

Строка не может иметь значение NULL и должна содержать то же имя компонента, которое использовалось при добавлении компонента в резервный набор с помощью IVssBackupComponents::AddComponent.

[in] iPartialFile

Номер индекса частичного файла. Значение этого параметра является целым числом от 0 до n–1 включительно, где n — общее количество частичных файлов, связанных с данным компонентом. Значение n возвращается IVssComponent::GetPartialFileCount.

[in] wszRangesFile

Строка расширенных символов со значением NULL, содержащая полный путь к файлу диапазонов.

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

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

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

Требования


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

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

IVssBackupComponents

IVssComponent::AddPartialFile

IVssComponent::GetPartialFile

IVssComponent::GetPartialFileCount