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

Статья
08/27/2023

Метод 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, дополнительные операции восстановления компонента не будут следовать за этим восстановлением.

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

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

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

Сведения, предоставляемые методом 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

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

IVssBackupComponents

IVssBackupComponents::P reRestore

VSS_COMPONENT_TYPE

Share via