Класс CVssWriter (vswriter.h)
Класс CVssWriter является абстрактным базовым классом, определяющим интерфейс, с помощью которого модуль записи синхронизирует свое состояние с VSS и другими модулями записи.
Каждый модуль записи должен создавать экземпляр объекта, производного от CVssWriter.
Объекты, производные от CVssWriter , должны предоставлять реализации для всех чистых виртуальных методов CVssWriter.
Модуль записи может переопределить один или все виртуальные методы CVssWriter.
Для участия в VSS модуль записи должен сначала вызвать CVssWriter::Initialize , а затем вызвать CVssWriter::Subscribe.
Модуль записи прекращает свое участие, вызывая CVssWriter::Unsubscribe.
Базовый класс CVssWriter отвечает за жизненный цикл интерфейсов, передаваемых обработчикам событий. Это включает следующие действия.
- Экземпляр интерфейса IVssWriterComponents, переданный в: CVssWriter::OnPrepareBackup
- Экземпляр интерфейса IVssCreateWriterMetadata, передаваемыйв CVssWriter::OnIdentify.
Методы
Класс CVssWriter содержит эти методы.
| CVssWriter::~CVssWriter ~CVssWriter является деструктором объекта класса CVssWriter. |
| CVssWriter::AreComponentsSelected Метод AreComponentsSelected указывает, работает ли инициатор запроса в режиме компонента и поддерживает выбор отдельных компонентов для резервного копирования или резервное копирование целых томов. |
| CVssWriter::CVssWriter CVssWriter — это конструктор объекта класса CVssWriter. |
| CVssWriter::GetBackupType Метод GetBackupType указывает тип выполняемого резервного копирования. |
| CVssWriter::GetContext Сведения GetContext возвращают текущий контекст для любых текущих или возможных теневых копий. |
| CVssWriter::GetCurrentLevel Метод GetCurrentLevel возвращает текущий уровень приложения. |
| CVssWriter::GetCurrentSnapshotSetId Метод GetCurrentSnapshotSetId возвращает уникальный идентификатор набора теневых копий. |
| CVssWriter::GetCurrentVolumeArray Метод GetCurrentVolumeArray возвращает имена исходных томов и UNC-пути исходных удаленных общих папок, принадлежащих набору теневого копирования в виде массива строк с широкими символами, заканчивающимися null. Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP и Windows Server 2003: удаленные общие папки не поддерживаются до Windows 8 и Windows Server 2012. |
| CVssWriter::GetCurrentVolumeCount Метод GetCurrentVolumeCount возвращает количество томов в наборе теневого копирования. |
| CVssWriter::GetRestoreType Метод GetRestoreType возвращает тип восстановления, в который участвует модуль записи. |
| CVssWriter::GetSnapshotDeviceName Метод GetSnapshotDeviceName возвращает имя устройства, на котором размещена теневая копия указанного тома или общей папки. |
| CVssWriter::Initialize Инициализирует объект CVssWriter и позволяет приложению записи взаимодействовать с VSS. |
| CVssWriter::InstallAlternateWriter Не поддерживается. (CVssWriter.InstallAlternateWriter) |
| CVssWriter::IsBootableSystemStateBackedUp Метод IsBootableSystemStateBackedUp указывает, будет ли выполняться резервное копирование загрузочного состояния. |
| CVssWriter::IsPartialFileSupportEnabled Метод IsPartialFileSupportEnabled определяет, включена или отключена поддержка частичного файла. |
| CVssWriter::IsPathAffected Метод IsPathAffected определяет, включен ли указанный каталог или файл в текущий набор теневого копирования. Путь к каталогу или файлу может быть локальным или UNC-путем к удаленной общей папке. |
| CVssWriter::OnAbort Метод OnAbort вызывается модулем записи после события Abort, выданного VSS, указывающего на преждевременное завершение операции теневого копирования. Модуль записи использует этот метод для очистки от попытки участия в этой операции. |
| CVssWriter::OnBackOffIOOnVolume Не поддерживается. (CVssWriter.OnBackOffIOOnVolume) |
| CVssWriter::OnBackupComplete Метод OnBackupComplete вызывается модулем записи после события BackupComplete. Он используется для выполнения операций, которые считаются необходимыми после резервного копирования. Однако эти операции не могут изменить документ компонентов резервного копирования. |
| CVssWriter::OnBackupShutdown Метод OnBackupShutdown вызывается модулем записи после события BackupShutdown. Он используется для выполнения операций, которые считаются необходимыми при завершении работы приложения резервного копирования, особенно в случае сбоя приложения резервного копирования. |
| CVssWriter::OnContinueIOOnVolume Не поддерживается. (CVssWriter.OnContinueIOOnVolume) |
| CVssWriter::OnFreeze Метод OnFreeze вызывается модулем записи при получении события Freeze в начале замораживания теневой копии. Модуль записи использует этот метод для выполнения операций, необходимых для участия в заморозке или для применения права вето на замораживание. |
| CVssWriter::OnIdentify Метод OnIdentify вызывается модулем записи после получения события Identify. |
| CVssWriter::OnPostRestore Метод OnPostRestore вызывается модулем записи после события PostRestore. Он используется для выполнения операций, которые считаются необходимыми после восстановления файлов на диск инициатором запроса. Однако эти операции не могут изменить документ компонентов резервного копирования. |
| CVssWriter::OnPostSnapshot Метод OnPostSnapshot вызывается модулем записи после события PostSnapshot. |
| CVssWriter::OnPrepareBackup Метод OnPrepareBackup вызывается модулем записи после события PrepareForBackup. Этот метод используется для настройки состояния модуля записи и его компонентов при подготовке к операции резервного копирования. |
| CVssWriter::OnPrepareSnapshot Метод OnPrepareSnapshot вызывается модулем записи для обработки события PrepareForSnapshot. Он используется для выполнения операций, необходимых для подготовки модуля записи к участию в теневой копии или для применения права вето на теневой копии. |
| CVssWriter::OnPreRestore Метод OnPreRestore вызывается модулем записи после события PreRestore. |
| CVssWriter::OnThaw Метод OnThaw вызывается модулем записи после события Thaw. |
| CVssWriter::OnVSSApplicationStartup Не поддерживается. (CVssWriter.OnVSSApplicationStartup) |
| CVssWriter::OnVSSShutdown Не поддерживается. (CVssWriter.OnVssShutdown) |
| CVssWriter::SetWriterFailure Метод SetWriterFailure указывает, что этот модуль записи столкнулся с ошибкой и задает условие ошибки. |
| CVssWriter::Subscribe Метод Subscribe подписывает модуль записи с помощью VSS. |
| CVssWriter::Unsubscribe Метод Unsubscribe отменяет подписку модуля записи с помощью VSS. |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | vswriter.h (включая Vss.h, VsWriter.h) |