Метод IVssCreateExpressWriterMetadata::SetRestoreMethod (vswriter.h)

Статья
03/08/2023

Указывает способ восстановления данных модуля записи express.

Синтаксис

HRESULT SetRestoreMethod(
  [in] VSS_RESTOREMETHOD_ENUM method,
  [in] LPCWSTR                wszService,
  [in] LPCWSTR                wszUserProcedure,
  [in] VSS_WRITERRESTORE_ENUM writerRestore,
  [in] bool                   bRebootRequired
);

Параметры

[in] method

Значение перечисления VSS_RESTOREMETHOD_ENUM , указывающее метод восстановления, используемый в операции восстановления. Этот параметр является обязательным и не может быть VSS_RME_UNDEFINED, VSS_RME_RESTORE_TO_ALTERNATE_LOCATION или VSS_RME_CUSTOM.

[in] wszService

Указатель на строку расширенных символов, содержащую имя службы, которая должна быть остановлена перед операцией восстановления, а затем запущена после выполнения операции восстановления, если значение методаVSS_RME_STOP_RESTORE_START или VSS_RME_RESTORE_STOP_START.

Если значение метода не является VSS_RME_STOP_RESTORE_START или VSS_RME_RESTORE_STOP_START, этот параметр не используется и должен иметь значение NULL.

[in] wszUserProcedure

Зарезервировано для последующего использования. Значение этого параметра всегда должно быть равно NULL.

[in] writerRestore

Значение перечисления VSS_WRITERRESTORE_ENUM , указывающее, будет ли модуль записи участвовать в восстановлении своих данных. Для этого параметра необходимо задать значение VSS_WRE_NEVER.

[in] bRebootRequired

Логическое значение, указывающее, требуется ли перезагрузка после завершения операции восстановления.

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

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

Значение	Значение
S_OK	Операция выполнена успешно.
E_INVALIDARG	Одно из значений параметра недопустимо.
E_OUTOFMEMORY	У вызывающего объекта не хватает памяти или других системных ресурсов.
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.

Экспресс-модуль записи может определить только один метод восстановления. Если метод восстановления не переопределен, все компоненты модуля записи express будут восстановлены с помощью того же метода.

Экспресс-модули записи переопределяют метод восстановления по компоненту, устанавливая целевой объект восстановления, как правило, при обработке события PreRestore (CVssWriter::OnPreRestore).

Важно отметить, что несмотря на то, что методы восстановления применяются для каждого модуля записи, методы реализуются для каждого компонента. Например, если метод, заданный параметром method , является VSS_RME_RESTORE_IF_CAN_REPLACE, то все файлы в компоненте восстанавливаются в исходное расположение, если все они могут быть заменены без возникновения ошибки. В противном случае они восстанавливаются в альтернативном расположении, если он указан.

Файл можно восстановить в альтернативном сопоставлении расположения, если выполняется одно из следующих действий:

Метод восстановления VSS_RME_RESTORE_IF_NOT_THERE, а версия файла уже присутствует на диске.
Метод восстановления VSS_RME_RESTORE_IF_CAN_REPLACE, а версия файла присутствует на диске и не может быть заменена.

Если допустимое альтернативное сопоставление расположения не определено, это ошибка записи.

Дополнительные сведения о методах восстановления см. в разделе Настройка методов восстановления VSS.

Если метод восстановления VSS_RME_STOP_RESTORE_START или VSS_RME_RESTORE_STOP_START, в качестве аргумента wszService необходимо указать правильное имя службы. Сведения об участии модуля записи в остановке и перезапуске служб во время операции восстановления см. в разделе Остановка служб для восстановления инициаторами запроса.

Требования

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

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

IVssCreateExpressWriterMetadata

Поделиться через