Метод IVssBackupComponents::SetBackupSucceeded (vsbackup.h)
Метод SetBackupSucceeded указывает, выполнена ли резервная копия указанного компонента определенного модуля записи.
Синтаксис
HRESULT SetBackupSucceeded(
[in] VSS_ID instanceId,
[in] VSS_ID writerId,
[in] VSS_COMPONENT_TYPE ct,
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszComponentName,
[in] bool bSucceded
);
Параметры
[in] instanceId
Глобальный уникальный идентификатор (GUID) экземпляра модуля записи.
[in] writerId
Глобальный уникальный идентификатор (GUID) класса записи.
[in] ct
Тип компонента. Возможные значения см. в VSS_COMPONENT_TYPE .
[in] wszLogicalPath
Строка расширенных символов со значением NULL, содержащая логический путь к компоненту.
Дополнительные сведения см. в разделе Логический путь к компонентам.
Значение строки, содержащей используемый здесь логический путь, должно совпадать с значением, которое использовалось при добавлении компонента в резервный набор данных с помощью IVssBackupComponents::AddComponent.
Логический путь может иметь значение NULL.
Нет ограничений на символы, которые могут отображаться в логическом пути, отличном от NULL .
[in] wszComponentName
Строка расширенных символов, завершающаяся null, содержащая имя компонента.
Строка не может иметь значение NULL и должна содержать то же имя компонента, которое использовалось при добавлении компонента в резервный набор данных с помощью IVssBackupComponents::AddComponent.
[in] bSucceded
Присвойте этому параметру значение true , если компонент успешно выполнил резервное копирование, или false в противном случае.
Возвращаемое значение
Ниже приведены допустимые коды возврата для этого метода.
| Значение | Значение |
|---|---|
|
Состояние резервного копирования успешно задано. |
|
Одно из значений параметра недопустимо. |
|
У вызывающего объекта не хватает памяти или других системных ресурсов. |
|
Объект компонентов резервного копирования не инициализирован, этот метод был вызван во время операции восстановления или этот метод не был вызван в правильной последовательности. |
|
Компонент резервного копирования не существует. |
|
Недопустимый XML-документ. Дополнительные сведения см. в журнале событий. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS. |
|
Непредвиденная ошибка. Код ошибки записывается в файл журнала ошибок. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows Server 2008 R2 и Windows 7. вместо этого используется E_UNEXPECTED. |
Комментарии
При работе в режиме компонента (при вызове метода IVssBackupComponents::SetBackupState с аргументом select components, равным true), записи проверка состояние резервного копирования каждого компонента с помощью IVssComponent::GetBackupSucceeded. Таким образом, правильное приложение резервного копирования (инициатор запроса) должно вызывать SetBackupSucceededed после обработки каждого компонента и перед вызовом IVssBackupComponents::BackupComplete.
Не вызывайте этот метод, если не удалось вызвать IVssBackupComponents::D oSnapshotSet . Дополнительные сведения о том, как инициаторы запроса используют DoSnapshotSet, SetBackupSucceeded и BackupComplete в операции резервного копирования, см. в разделах Обзор задач предварительного резервного копирования и Обзор фактического резервного копирования файлов.
Требования
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | vsbackup.h (включая VsBackup.h, Vss.h, VsWriter.h) |
| Библиотека | VssApi.lib |
См. также раздел
IVssBackupComponents::BackupComplete