Класс CVssWriter (vswriter.h)

  • Статья

Класс CVssWriter является абстрактным базовым классом, определяющим интерфейс, с помощью которого модуль записи синхронизирует свое состояние с VSS и другими модулями записи.

Каждый модуль записи должен создавать экземпляр объекта, производного от CVssWriter.

Объекты, производные от CVssWriter , должны предоставлять реализации для всех чистых виртуальных методов CVssWriter.

Модуль записи может переопределить один или все виртуальные методы CVssWriter.

Для участия в VSS модуль записи должен сначала вызвать CVssWriter::Initialize , а затем вызвать CVssWriter::Subscribe.

Модуль записи прекращает свое участие, вызывая CVssWriter::Unsubscribe.

Базовый класс CVssWriter отвечает за жизненный цикл интерфейсов, передаваемых обработчикам событий. Это включает следующие действия.

CVssWriter имеет следующие типы членов:

Методы

Класс 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)