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

Статья
08/27/2023

Помечает восстановление компонента как заслуживающее доверия для реплицированного хранилища данных.

Синтаксис

HRESULT SetAuthoritativeRestore(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE ct,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] bool               bAuth
);

Параметры

[in] writerId

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

[in] ct

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

[in] wszLogicalPath

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

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

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

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

[in] wszComponentName

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

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

[in] bAuth

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

Значение по умолчанию — false.

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

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

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

Требования


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

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

IVssBackupComponents::SetRestoreOptions

IVssBackupComponentsEx2

IVssComponentEx::GetAuthoritativeRestore

VSS_BACKUP_SCHEMA

Share via