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