Поделиться через


Класс IVssComponent (vswriter.h)

Интерфейс IVssComponent — это интерфейс C++ (не COM), содержащий методы для проверки и изменения сведений о компонентах, содержащихся в документе компонентов резервного копирования инициатора запроса.

Объекты IVssComponent можно получить только для тех компонентов, которые были явно добавлены в документ компонентов резервного копирования во время операции резервного копирования методом IVssBackupComponents::AddComponent.

Сведения о компонентах, явно добавленных во время операции восстановления с помощью IVssBackupComponents::AddRestoreSubcomponent , недоступны через интерфейс IVssComponent .

Ниже приведены некоторые сведения, общие для обоих компонентов и неявно выбранных подкомпонентов, доступных через объекты IVssComponent :

  • Метка времени резервного копирования
  • Сообщения о сбоях перед и после восстановления
  • Восстановление метаданных
  • Целевой объект восстановления
Некоторые сведения в объекте 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)