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

Статья
08/27/2023

Метод SetSelectedForRestore указывает, выбран ли для восстановления указанный выбираемый компонент.

Синтаксис

HRESULT SetSelectedForRestore(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE ct,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] bool               bSelectedForRestore
);

Параметры

[in] writerId

Идентификатор модуля записи.

[in] ct

Тип компонента. Возможные значения см. в VSS_COMPONENT_TYPE .

[in] wszLogicalPath

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

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

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

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

[in] wszComponentName

Строка расширенных символов, завершающаяся null, содержащая имя компонента.

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

[in] bSelectedForRestore

Если значение этого параметра равно true, выбранный компонент выбран для восстановления. Если значение равно false, выбранный компонент не выбран для восстановления.

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

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

Значение	Значение
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.

Метод SetSelectedForRestore можно вызывать только для компонентов, которые были явно добавлены в документ резервной копии во время резервного копирования с помощью IVssBackupComponents::AddComponent. Восстановление компонента, который был неявно выбран для резервного копирования в составе набора компонентов, должно выполняться путем вызова метода SetSelectedForRestore для ближайшего компонента-предка, добавленного в документ. Если требуется восстановить только данные этого компонента, это должно быть выполнено с помощью IVssBackupComponents::AddRestoreSubcomponent; Это можно сделать, только если компонент можно выбрать для восстановления (см. раздел Работа с возможностью выбора и логическими путями).

Этот метод должен вызываться перед IVssBackupComponents::P reRestore.

Требования

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

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

IVssBackupComponents

IVssBackupComponents::P reRestore

IVssComponent::IsSelectedForRestore

VSS_COMPONENT_TYPE