Метод IVssBackupComponentsEx2::SetRollForward (vsbackup.h)

  • Статья

Задает тип операции наката для компонента и указывает точку восстановления для частичной операции наката.

Синтаксис

HRESULT SetRollForward(
  [in] VSS_ID               writerId,
  [in] VSS_COMPONENT_TYPE   ct,
  [in] LPCWSTR              wszLogicalPath,
  [in] LPCWSTR              wszComponentName,
  [in] VSS_ROLLFORWARD_TYPE rollType,
  [in] LPCWSTR              wszRollForwardPoint
);

Параметры

[in] writerId

Глобальный уникальный идентификатор (GUID) класса записи.

[in] ct

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

[in] wszLogicalPath

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

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

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

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

[in] wszComponentName

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

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

[in] rollType

Значение VSS_ROLLFORWARD_TYPE перечисления, указывающее тип выполняемой операции наката.

[in] wszRollForwardPoint

Строка расширенных символов со значением NULL, указывающая точку восстановления наката.

Формат этой строки определяется модулем записи и может быть меткой времени, порядковым номером журнала (LSN) или любым маркером, определенным модулем записи.

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

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

Значение Значение
S_OK
 Тип операции наката и точка восстановления успешно заданы.
E_INVALIDARG
 Одно из значений параметра является недопустимым.
E_OUTOFMEMORY
 Вызывающий объект не имеет памяти или других системных ресурсов.
VSS_E_BAD_STATE
 Этот метод не был вызван во время операции восстановления.
VSS_E_OBJECT_NOT_FOUND
 Указанный компонент не найден.
VSS_E_UNEXPECTED
 Непредвиденная ошибка. Код ошибки регистрируется в файле журнала ошибок. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows Server 2008 R2 и Windows 7. вместо этого используется E_UNEXPECTED.

Комментарии

Метод SetRollForward можно вызывать только во время операции восстановления.

Модуль записи указывает, что он поддерживает этот метод, установив флаг VSS_BS_ROLLFORWARD_RESTORE в маске резервной схемы.

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

Требования

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

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

IVssBackupComponentsEx2

IVssComponentEx::GetRollForward

VSS_BACKUP_SCHEMA

VSS_ROLLFORWARD_TYPE