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 메서드는 IVssComponent::SetBackupMetadata를 사용하여 CVssWriter::OnPrepareBackup에 의해 PrepareForBackup 이벤트 중에 설정되었을 수 있는 기록기별 프라이빗 백업 메타데이터를 검색합니다.
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 메서드는 IVssComponent::SetPostRestoreFailureMsg가 1을 설정한 경우 PostRestore 이벤트를 처리하는 동안 기록기에서 생성된 실패 메시지를 반환합니다.
IVssComponent::GetPreRestoreFailureMsg GetPreRestoreFailureMsg 메서드는 IVssComponent::SetPreRestoreFailureMsg가 1을 설정한 경우 PreRestore 이벤트를 처리하는 동안 기록기에서 생성된 오류 메시지를 검색합니다.
IVssComponent::GetPreviousBackupStamp GetPreviousBackupStamp 메서드는 백업 구성 요소 문서의 요청자가 로드한 이전 백업 스탬프를 반환합니다. 이 값은 파일이 차등 백업 또는 증분 백업 작업에 참여해야 하는지 여부를 결정할 때 기록기에서 사용됩니다.
IVssComponent::GetRestoreMetadata GetRestoreMetadata 메서드는 IVssComponent::SetRestoreMetadata를 사용하여 CVssWriter::OnPreRestore에 의해 PreRestore 이벤트 중에 설정되었을 수 있는 기록기별 프라이빗 복원 메타데이터를 검색합니다.
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
헤더	vswriter.h(Vss.h, VsWriter.h 포함)