Класс IVssComponent (vswriter.h)

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

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

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

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

• Метка времени резервного копирования
• Сообщения о сбоях перед и после восстановления
• Восстановление метаданных
• Целевой объект восстановления

Некоторые сведения в объекте IVssComponent относятся к отдельным файлам и могут ссылаться на файлы, управляемые явно выбранными компонентами или неявно выбранными подкомпонентами:

• Сопоставления альтернативных расположений
• Частичные файлы
• Направленный целевой объект

Другие сведения не включаются в документ компонентов резервного копирования и могут быть выведены с помощью объекта IVssComponent в сочетании с соответствующими документами метаданных модуля записи на основе иерархии компонентов модуля записи, выраженной в логических путях (см. раздел Работа с возможностью выбора и логическими путями).

Интерфейс может использоваться либо модулем записи, либо инициатором запроса, хотя некоторые методы поддерживаются только для модулей записи. Таким образом, модуль записи может запросить изменения в операции резервного копирования или восстановления, например добавить новый целевой объект, или узнать о действиях инициатора запроса, таких как использование альтернативного расположения.

Следующие методы возвращают интерфейс IVssComponent :

• IVssWriterComponents::GetComponent
• IVssWriterComponentsExt::GetComponent

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

Интерфейс 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)