Метод IVssBackupComponentsEx2::SetAuthoritativeRestore (vsbackup.h)
Помечает восстановление компонента как заслуживающее доверия для реплицированного хранилища данных.
Синтаксис
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.
Возвращаемое значение
Ниже приведены допустимые коды возврата для этого метода.
| Значение | Значение |
|---|---|
|
Восстановление компонента было успешно установлено как заслуживающее доверия или неавторитативное. |
|
Одно из значений параметра является недопустимым. |
|
Вызывающий объект не имеет памяти или других системных ресурсов. |
|
Этот метод не был вызван во время операции восстановления. |
|
Указанный компонент не найден. |
|
Непредвиденная ошибка. Код ошибки регистрируется в файле журнала ошибок. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows Server 2008 R2 и Windows 7. вместо этого используется E_UNEXPECTED. |
Комментарии
Метод SetAuthoritativeRestore можно вызывать только во время операции восстановления.
Модуль записи указывает, что он поддерживает заслуживающее доверия восстановление, установив флаг VSS_BS_AUTHORITATIVE_RESTORE в маске резервной схемы.
Дополнительные сведения см. в разделе Настройка параметров восстановления VSS.
Требования
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | vsbackup.h (включая VsBackup.h, Vss.h, VsWriter.h) |
| Библиотека | VssApi.lib |
См. также раздел
IVssBackupComponents::SetRestoreOptions