Метод IVssBackupComponents::SetSelectedForRestore (vsbackup.h)
Метод 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, выбранный компонент не выбран для восстановления.
Возвращаемое значение
Ниже приведены допустимые коды возврата для этого метода.
| Значение | Значение |
|---|---|
|
Успешно указано, что указанный компонент выбран для восстановления. |
|
Одно из значений параметра недопустимо. |
|
У вызывающего объекта не хватает памяти или других системных ресурсов. |
|
Объект компонентов резервного копирования не инициализирован, этот метод был вызван во время операции восстановления или этот метод не был вызван в правильной последовательности. |
|
Выбранный компонент не существует в документе о компонентах резервного копирования или динамический экземпляр модуля записи, соответствующий этому компоненту, не запущен в системе. |
|
Недопустимый XML-документ. Дополнительные сведения см. в журнале событий. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS. |
|
Непредвиденная ошибка. Код ошибки записывается в файл журнала ошибок. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows Server 2008 R2 и Windows 7. вместо этого используется E_UNEXPECTED. |
Комментарии
SetSelectedForRestore имеет значение только для восстановления, происходящих в режиме компонента.
Метод 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::P reRestore