Класс IVssComponent (vswriter.h)
Интерфейс IVssComponent — это интерфейс C++ (не COM), содержащий методы для проверки и изменения сведений о компонентах, содержащихся в документе компонентов резервного копирования инициатора запроса.
Объекты IVssComponent можно получить только для тех компонентов, которые были явно добавлены в документ компонентов резервного копирования во время операции резервного копирования методом IVssBackupComponents::AddComponent.
Сведения о компонентах, явно добавленных во время операции восстановления с помощью IVssBackupComponents::AddRestoreSubcomponent , недоступны через интерфейс IVssComponent .
Ниже приведены некоторые сведения, общие для обоих компонентов и неявно выбранных подкомпонентов, доступных через объекты IVssComponent :
- Метка времени резервного копирования
- Сообщения о сбоях перед и после восстановления
- Восстановление метаданных
- Целевой объект восстановления
- Сопоставления альтернативных расположений
- Частичные файлы
- Направленный целевой объект
Интерфейс может использоваться либо модулем записи, либо инициатором запроса, хотя некоторые методы поддерживаются только для модулей записи. Таким образом, модуль записи может запросить изменения в операции резервного копирования или восстановления, например добавить новый целевой объект, или узнать о действиях инициатора запроса, таких как использование альтернативного расположения.
Следующие методы возвращают интерфейс IVssComponent :
Наследование
Интерфейс IVssComponent наследуется от интерфейса IUnknown . IVssComponent также имеет следующие типы членов:
Методы
Класс IVssComponent содержит следующие методы.
| IVssComponent::AddDifferencedFilesByLastModifyLSN Не поддерживается. (IVssComponent.AddDifferencedFilesByLastModifyLSN) |
| IVssComponent::AddDifferencedFilesByLastModifyTime Используется модулем записи, чтобы указать, что набор файлов (указанный файл или файлы) должен оцениваться по метке времени последнего изменения для включения в добавочную или разностную резервную копию с меткой времени с использованием целых файлов. |
| IVssComponent::AddDirectedTarget Метод AddDirectedTarget позволяет модулю записи указывать во время восстановления, что при восстановлении файла необходимо переназначать его (исходный файл). |
| IVssComponent::AddPartialFile Метод AddPartialFile указывает, что резервные копии должны выполняться только для тех частей файла, которые должны быть резервными. |
| IVssComponent::GetAdditionalRestores Метод GetAdditionalRestores используется модулем записи во время добавочных или разностных операций восстановления, чтобы определить, требуются ли для данного компонента дополнительные операции восстановления для его полного извлечения. |
| IVssComponent::GetAlternateLocationMapping GetAlternateLocationMapping используется для возврата альтернативного расположения набора файлов для восстановления файлов. Этот метод может вызываться либо модулем записи, либо инициатором запроса. |
| IVssComponent::GetAlternateLocationMappingCount Метод GetAlternateLocationMappingCount возвращает количество альтернативных сопоставлений расположений, используемых инициатором запроса при восстановлении данных. Этот метод может вызвать модуль записи или инициатор запроса. |
| IVssComponent::GetBackupMetadata Метод GetBackupMetadata извлекает частные метаданные резервной копии, относящиеся к средству записи, которые могли быть заданы во время события PrepareForBackup cvssWriter::OnPrepareBackup с помощью IVssComponent::SetBackupMetadata. |
| IVssComponent::GetBackupOptions Метод GetBackupOptions возвращает параметры резервного копирования, указанные модулю записи, которая управляет текущим выбранным компонентом или компонентом, заданным инициатором запроса, с помощью IVssBackupComponents::SetBackupOptions. |
| IVssComponent::GetBackupStamp Метод GetBackupStamp возвращает строку метки резервной копии, хранящуюся модулем записи для данного компонента. |
| IVssComponent::GetBackupSucceeded Метод GetBackupSucceeded возвращает состояние полной попытки резервного копирования всех файлов выбранного компонента или набора компонентов в виде перечисления VSS_FILE_RESTORE_STATUS. |
| IVssComponent::GetComponentName Метод GetComponentName возвращает логическое имя этого компонента. |
| IVssComponent::GetComponentType Метод GetComponentType возвращает тип этого компонента с точки зрения перечисления VSS_COMPONENT_TYPE. |
| IVssComponent::GetDifferencedFile Метод GetDifferencedFile возвращает сведения о наборе файлов (указанном файле или файлах) для участия в добавочном или разностном резервном копировании или восстановлении в виде разностного файла, то есть резервное копирование и восстановление, связанные с ним, должны быть реализованы так, как если бы все файлы копировались на носитель резервных копий и с него (в отличие от использования частичных файлов). |
| IVssComponent::GetDifferencedFilesCount Возвращает число спецификаций файлов в этом компоненте (и в любых подкомпонентах определяемого им набора компонентов), помеченное модулем записи, поддерживающей добавочное резервное копирование или восстановление, как разностные файлы. |
| IVssComponent::GetDirectedTarget Метод GetDirectedTarget возвращает сведения, хранящиеся модулем записи во время резервного копирования, в документ компонентов резервной копии, чтобы указать, что при восстановлении файла его (исходный файл) необходимо перенаставить. |
| IVssComponent::GetDirectedTargetCount Метод GetDirectedTargetCount возвращает количество целевых спецификаций, связанных с текущим компонентом. Этот метод может вызвать модуль записи или инициатор запроса. |
| IVssComponent::GetFileRestoreStatus Метод GetFileRestoreStatus возвращает состояние завершенной попытки восстановления всех файлов выбранного компонента или набора компонентов в виде перечисления VSS_FILE_RESTORE_STATUS. |
| IVssComponent::GetLogicalPath Метод GetLogicalPath возвращает логический путь к этому компоненту. |
| IVssComponent::GetNewTarget Метод GetNewTarget возвращает новые расположения восстановления файлов для выбранного компонента или набора компонентов. |
| IVssComponent::GetNewTargetCount Метод GetNewTargetCount возвращает количество новых целевых расположений восстановления, связанных с данным компонентом. |
| IVssComponent::GetPartialFile Метод GetPartialFile возвращает сведения о частичном файле, связанном с этим компонентом. |
| IVssComponent::GetPartialFileCount Метод GetPartialFileCount возвращает количество частичных файлов, связанных с компонентом. |
| IVssComponent::GetPostRestoreFailureMsg Метод GetPostRestoreFailureMsg возвращает сообщение об ошибке, созданное модулем записи при обработке события PostRestore, если IVssComponent::SetPostRestoreFailureMsg задано значение . |
| IVssComponent::GetPreRestoreFailureMsg Метод GetPreRestoreFailureMsg извлекает сообщение об ошибке, созданное модулем записи при обработке события PreRestore, если IVssComponent::SetPreRestoreFailureMsg устанавливает его. |
| IVssComponent::GetPreviousBackupStamp Метод GetPreviousBackupStamp возвращает предыдущую метку резервной копии, загруженную инициатором запроса в документе Компонентов резервной копии. Значение используется модулем записи при принятии решения о том, должны ли файлы участвовать в разностном или добавочном резервном копировании. |
| IVssComponent::GetRestoreMetadata Метод GetRestoreMetadata извлекает частные метаданные восстановления, относящиеся к средству записи, которые могли быть заданы во время события PreRestore CVssWriter::OnPreRestore с помощью IVssComponent::SetRestoreMetadata. |
| IVssComponent::GetRestoreOptions Метод GetRestoreOptions получает параметры восстановления, заданные для текущего модуля записи инициатором запроса, с помощью IVssBackupComponents::SetRestoreOptions. |
| IVssComponent::GetRestoreSubcomponent Метод GetRestoreSubcomponent возвращает указанный подкомпонент, связанный с заданным компонентом. |
| IVssComponent::GetRestoreSubcomponentCount Метод GetRestoreSubcomponentCount возвращает количество подкомпонентов, связанных с компонентом. |
| IVssComponent::GetRestoreTarget Метод GetRestoreTarget возвращает целевой объект восстановления (с точки зрения перечисления VSS_RESTORE_TARGET) для текущего компонента. |
| IVssComponent::IsSelectedForRestore Метод IsSelectedForRestore определяет, выбран ли текущий компонент для восстановления. |
| IVssComponent::SetBackupMetadata Метод SetBackupMetadata задает метаданные резервной копии с помощью компонента . |
| IVssComponent::SetBackupStamp Метод SetBackupStamp задает строку, содержащую сведения, указывающие, когда была создана резервная копия. |
| IVssComponent::SetPostRestoreFailureMsg Метод SetPostRestoreFailureMsg используется для создания сообщения, описывающего сбой при обработке события PostRestore. |
| IVssComponent::SetPreRestoreFailureMsg Метод SetPreRestoreFailureMsg используется для создания сообщения, описывающего сбой при обработке события PreRestore. |
| IVssComponent::SetRestoreMetadata Метод SetRestoreMetadata задает метаданные модуля записи для текущего компонента. |
| IVssComponent::SetRestoreTarget Метод SetRestoreTarget задает целевой объект восстановления (с точки зрения перечисления VSS_RESTORE_TARGET) для текущего компонента. |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | vswriter.h (включая Vss.h, VsWriter.h) |