Класс IVssBackupComponents (vsbackup.h)

Интерфейс IVssBackupComponents используется инициатором запроса для опроса записи о состоянии файла и выполнения операций резервного копирования и восстановления.

Приложения получают экземпляр интерфейса IVssBackupComponents путем вызова CreateVssBackupComponents.

Объект IVssBackupComponents можно использовать только для одной операции резервного копирования, восстановления или запроса .

После успешного завершения или явного завершения операции резервного копирования, восстановления или запроса запрашивающий объект должен освободить объект IVssBackupComponents , вызвав IVssBackupComponents::Release. Объект IVssBackupComponents не должен использоваться повторно. Например, нельзя выполнить операцию резервного копирования или восстановления с тем же объектом IVssBackupComponents , который вы уже использовали для операции запроса .

Наследование

Интерфейс IVssBackupComponents наследуется от интерфейса IUnknown . IVssBackupComponents также имеет следующие типы элементов:

Методы

Класс IVssBackupComponents содержит следующие методы.

IVssBackupComponents::AbortBackup Метод AbortBackup уведомляет VSS о завершении операции резервного копирования.
IVssBackupComponents::AddAlternativeLocationMapping Метод AddAlternativeLocationMapping используется инициатором запроса, чтобы указать, что сопоставление альтернативного расположения использовалось для восстановления всех элементов набора файлов в данном компоненте.
IVssBackupComponents::AddComponent Используется для явного добавления в резервный набор данных.
IVssBackupComponents::AddNewTarget Метод AddNewTarget используется инициатором запроса во время операции восстановления, чтобы указать, что приложение резервного копирования планирует восстановить файлы в новом расположении.
IVssBackupComponents::AddRestoreSubcomponent Указывает, что подкомпонентный элемент набора компонентов, который был помечен как неизбираемый для резервного копирования, но помечен как доступный для восстановления, должен быть восстановлен.
IVssBackupComponents::AddToSnapshotSet Метод AddToSnapshotSet добавляет исходный том или исходный удаленный файловый ресурс в набор теневого копирования.
IVssBackupComponents::BackupComplete Метод BackupComplete приводит к тому, что VSS создает событие BackupComplete, которое сообщает о завершении процесса резервного копирования.
IVssBackupComponents::BreakSnapshotSet Метод BreakSnapshotSet приводит к тому, что VSS "забывает" о существовании набора теневых копий.
IVssBackupComponents::D eleteSnapshots Метод DeleteSnapshots удаляет одну или несколько теневых копий или набор теневого копирования.
IVssBackupComponents::D isableWriterClasses Метод DisableWriterClasses предотвращает получение событий определенным классом средств записи.
IVssBackupComponents::D isableWriterInstances Метод DisableWriterInstances отключает указанный экземпляр модуля записи или экземпляры.
IVssBackupComponents::D oSnapshotSet Одновременно фиксирует все теневые копии в этом наборе.
IVssBackupComponents::EnableWriterClasses Метод EnableWriterClasses позволяет указанным модулям записи получать все события.
IVssBackupComponents::ExposeSnapshot Метод ExposeSnapshot предоставляет теневые копии в виде буквы диска, подключенной папки или общей папки.
IVssBackupComponents::FreeWriterMetadata Метод FreeWriterMetadata освобождает системные ресурсы, выделенные при вызове IVssBackupComponents::GatherWriterMetadata.
IVssBackupComponents::FreeWriterStatus Метод FreeWriterStatus освобождает системные ресурсы, выделенные во время вызова IVssBackupComponents::GatherWriterStatus.
IVssBackupComponents::GatherWriterMetadata Метод CollectWriterMetadata предлагает каждому средству записи отправить собранные метаданные. Метод создает событие Identify для взаимодействия с средствами записи.
IVssBackupComponents::GatherWriterStatus Метод CollectWriterStatus предлагает каждому средству записи отправить сообщение о состоянии.
IVssBackupComponents::GetSnapshotProperties Метод GetSnapshotProperties получает свойства указанной теневой копии.
IVssBackupComponents::GetWriterComponents Метод GetWriterComponents используется для возврата сведений о тех компонентах данного модуля записи, которые были сохранены в документе компонентов резервного копирования инициатора запроса.
IVssBackupComponents::GetWriterComponentsCount Метод GetWriterComponentsCount возвращает количество модулей записи, компоненты которых были добавлены в документ компонентов резервного копирования инициатора запроса.
IVssBackupComponents::GetWriterMetadata Метод GetWriterMetadata возвращает метаданные для определенного модуля записи, работающего в системе.
IVssBackupComponents::GetWriterMetadataCount Метод GetWriterMetadataCount возвращает количество записей с метаданными.
IVssBackupComponents::GetWriterStatus Метод GetWriterStatus возвращает состояние указанного модуля записи.
IVssBackupComponents::GetWriterStatusCount Метод GetWriterStatusCount возвращает количество записей с состоянием.
IVssBackupComponents::ImportSnapshots Импортирует теневые копии, перенесенные с другого компьютера.
IVssBackupComponents::InitializeForBackup Метод InitializeForBackup инициализирует метаданные компонентов резервного копирования при подготовке к резервному копированию.
IVssBackupComponents::InitializeForRestore Метод InitializeForRestore инициализирует интерфейс IVssBackupComponents при подготовке к операции восстановления.
IVssBackupComponents::IsVolumeSupported Метод IsVolumeSupported определяет, поддерживает ли указанный поставщик теневые копии на указанном томе или в удаленном файловом ресурсе.
IVssBackupComponents::P ostRestore Метод PostRestore приведет к тому, что VSS создаст событие PostRestore, указывая на то, что текущая операция восстановления завершена.
IVssBackupComponents::P repareForBackup Метод PrepareForBackup приведет к тому, что VSS создаст событие PrepareForBackup, сигнализирует модулям записи о подготовке к предстоящей операции резервного копирования. Это делает документ компонентов резервного копирования инициатора запроса доступным для записи.
IVssBackupComponents::P reRestore Метод PreRestore приведет к тому, что VSS создаст событие PreRestore, сигналив записи о необходимости подготовки к предстоящей операции восстановления.
IVssBackupComponents::Query Метод Query запрашивает поставщиков в системе и (или) завершенные теневые копии в системе, которые находятся в текущем контексте. Метод можно вызывать только во время операций резервного копирования.
IVssBackupComponents::QueryRevertStatus Возвращает указатель интерфейса IVssAsync, который можно использовать для определения состояния операции отменить изменения. (IVssBackupComponents.QueryRevertStatus)
IVssBackupComponents::RevertToSnapshot Возвращает том к предыдущей теневой копии. (IVssBackupComponents.RevertToSnapshot)
IVssBackupComponents::SaveAsXML Метод SaveAsXML сохраняет документ компонентов резервного копирования, содержащий сведения о состоянии инициатора запроса, в указанную строку. Этот XML-документ, содержащий документ компонентов резервного копирования, всегда должен быть безопасно сохранен в рамках операции резервного копирования.
IVssBackupComponents::SetAdditionalRestores Метод SetAdditionalRestores используется инициатором запроса во время добавочных или разностных операций восстановления, чтобы сообщить записи о том, что для полного извлечения данного компонента потребуются дополнительные операции восстановления.
IVssBackupComponents::SetBackupOptions Метод SetBackupOptions задает строку частных параметров резервного копирования или зависимых от записи параметров резервного копирования для компонента.
IVssBackupComponents::SetBackupState Метод SetBackupState определяет общую конфигурацию для операции резервного копирования.
IVssBackupComponents::SetBackupSucceededed Метод SetBackupSucceeded указывает, успешно ли выполнено резервное копирование указанного компонента конкретного модуля записи.
IVssBackupComponents::SetContext Метод SetContext задает контекст для последующих операций, связанных с теневым копированием.
IVssBackupComponents::SetFileRestoreStatus Метод SetFileRestoreStatus указывает, были ли восстановлены некоторые, все или нет файлы.
IVssBackupComponents::SetPreviousBackupStamp Метод SetPreviousBackupStamp задает метку резервного копирования более ранней операции резервного копирования, на которой будет основана разностная или добавочная операция резервного копирования.
IVssBackupComponents::SetRangesFilePath Метод SetRangesFilePath используется, когда для операции с частичным файлом требуется файл диапазонов, и этот файл был восстановлен в расположение, отличное от исходного.
IVssBackupComponents::SetRestoreOptions Метод SetRestoreOptions задает строку частных параметров восстановления или зависимых от записи параметров для компонента записи.
IVssBackupComponents::SetRestoreState Метод SetRestoreState определяет общую конфигурацию операции восстановления.
IVssBackupComponents::SetSelectedForRestore Метод SetSelectedForRestore указывает, выбран ли указанный компонент для восстановления.
IVssBackupComponents::StartSnapshotSet Метод StartSnapshotSet создает новый пустой набор теневых копий.

Требования

Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	vsbackup.h (включая VsBackup.h, Vss.h, VsWriter.h)