перечисление VSS_FILE_RESTORE_STATUS (vswriter.h)

  • Статья

Перечисление VSS_FILE_RESTORE_STATUS определяет набор состояний операции восстановления файлов, выполняемой с файлами, управляемыми выбранным компонентом или набором компонентов (сведения о выборе компонентов см. в разделе Работа с возможностью выбора и логическими путями ).

Синтаксис

typedef enum VSS_FILE_RESTORE_STATUS {
  VSS_RS_UNDEFINED = 0,
  VSS_RS_NONE,
  VSS_RS_ALL,
  VSS_RS_FAILED
} ;

Константы

 
VSS_RS_UNDEFINED
Значение: 0
Состояние восстановления не определено.


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

Это значение не поддерживается для компонентов, принадлежащих экспресс-записи.
VSS_RS_NONE
Файлы не были восстановлены.


Это значение указывает на ошибку при восстановлении, которая не оставила восстановленные файлы на диске.
VSS_RS_ALL
Все файлы были восстановлены. Это значение указывает на успешное выполнение и должно быть задано для каждого компонента, который был
восстановлено успешно.
VSS_RS_FAILED
Сбой процесса восстановления.


Это значение указывает на ошибку при восстановлении, которая оставила некоторые восстановленные файлы на диске. Это означает, что
Компоненты на диске теперь повреждены.

Комментарии

Если какие-либо файлы, управляемые компонентом, или если он определяет набор компонентов, любой из его подкомпонентов не может быть восстановлен, значение VSS_FILE_RESTORE_STATUS должно указывать на ошибку.

Значения VSS_RS_FAILED и VSS_RS_NONE указывают на то, что операция восстановления не была успешно завершена:

  • VSS_RS_NONE указывает, что восстановление завершилось корректно: файлы компонента или его подкомпонентов не были восстановлены на диск.
  • VSS_RS_FAIL указывает на то, что восстановление завершилось безошибоку, в результате чего некоторые файлы были восстановлены на диске, а некоторые — без ограничений.
Инициаторы запроса должны задать состояние восстановления (с помощью IVssBackupComponents::SetFileRestoreStatus) для каждого компонента (и его набора компонентов, если он определяет его), явно добавленного для восстановления в документ компонентов резервного копирования (с помощью IVssBackupComponents::SetSelectedForRestore или IVssBackupComponents::AddRestoreSubcomponent).

Модули записи и инициаторы запроса могут запрашивать состояние восстановления компонента или набора компонентов, определенного выбираемым компонентом, с помощью вызовов IVssComponent::GetFileRestoreStatus. Если этот метод вызывается для компонента, который не был выбран, возвращаемое значение не определено.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть vswriter.h

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

IVssBackupComponents::SetFileRestoreStatus

IVssComponent::GetFileRestoreStatus