Метод IVssBackupComponents::SetAdditionalRestores (vsbackup.h)
Метод SetAdditionalRestores используется инициатором запроса во время добавочных или разностных операций восстановления, чтобы указать авторам, что данный компонент потребует дополнительных операций восстановления для его полного извлечения.
Синтаксис
HRESULT SetAdditionalRestores(
[in] VSS_ID writerId,
[in] VSS_COMPONENT_TYPE ct,
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszComponentName,
[in] bool bAdditionalRestores
);
Параметры
[in] writerId
Идентификатор модуля записи.
[in] ct
Тип компонента. Возможные значения см. в VSS_COMPONENT_TYPE .
[in] wszLogicalPath
Строка расширенных символов со знаком null, содержащая логический путь добавляемого компонента.
Дополнительные сведения см. в разделе Логический путь к компонентам.
Значение строки, содержащей используемый здесь логический путь, должно совпадать с значением, которое использовалось при добавлении компонента в резервный набор данных с помощью IVssBackupComponents::AddComponent.
Логический путь может иметь значение NULL.
Нет ограничений на символы, которые могут отображаться в логическом пути, отличном от NULL .
[in] wszComponentName
Строка расширенных символов, завершающаяся null, содержащая имя компонента.
Значение строки не должно иметь значение NULL и должно содержать тот же компонент, который использовался при добавлении компонента в резервный набор данных с помощью IVssBackupComponents::AddComponent.
[in] bAdditionalRestores
Если значение этого параметра равно true, после этого восстановления будет выполнено дополнительное восстановление компонента. Если значение равно false, дополнительные операции восстановления компонента не будут следовать за этим восстановлением.
Возвращаемое значение
Ниже приведены допустимые коды возврата для этого метода.
| Значение | Значение |
|---|---|
|
Дополнительное состояние восстановления успешно задано. |
|
Одно из значений параметра недопустимо. |
|
У вызывающего объекта не хватает памяти или других системных ресурсов. |
|
Объект компонентов резервного копирования не инициализирован, этот метод был вызван во время операции восстановления или этот метод не был вызван в правильной последовательности. |
|
Компонент резервного копирования не существует. |
|
Недопустимый XML-документ. Дополнительные сведения см. в журнале событий. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS. |
|
Непредвиденная ошибка. Код ошибки записывается в файл журнала ошибок. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows Server 2008 R2 и Windows 7. вместо этого используется E_UNEXPECTED. |
Комментарии
Сведения, предоставляемые методом SetAdditionalRestores, обычно используются средствами записи, поддерживающие явный механизм восстановления, как часть обработчика событий PostRestore (CVssWriter::OnPostRestore), например Exchange Server и приложения базы данных, такие как SQL Server. Для этих приложений часто невозможно выполнить дополнительное разностное, добавочное восстановление или восстановление журналов после выполнения такого восстановления.
Таким образом, если setAdditionalRestores для компонента установлено значение true, это означает, что такой модуль записи не должен выполнять свой механизм явного восстановления и ожидать, что будут выполнены дополнительные разностные, добавочные или журналы восстановления.
Если setAdditionalRestores для компонента установлено значение false, то после восстановления компонента приложение может завершить операцию восстановления и вернуться в оперативный режим.
Этот метод должен вызываться перед IVssBackupComponents::P reRestore.
Требования
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | vsbackup.h (включая VsBackup.h, Vss.h, VsWriter.h) |
| Библиотека | VssApi.lib |