IVssBackupComponents::AddRestoreSubcomponent 메서드(vsbackup.h)

  • 아티클

AddRestoreSubcomponent 메서드는 구성 요소 집합의 하위 구성 요소 멤버가 백업에 대해 선택 불가능으로 표시되었지만 복원을 위해 선택 가능한 것으로 표시되었으므로 구성 요소 집합의 다른 멤버가 복원될지 여부에 관계없이 복원될 것임을 나타냅니다.

구문

HRESULT AddRestoreSubcomponent(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE componentType,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] LPCWSTR            wszSubComponentLogicalPath,
  [in] LPCWSTR            wszSubComponentName,
  [in] bool               bRepair
);

매개 변수

[in] writerId

기록기 클래스 식별자입니다.

[in] componentType

구성 요소의 유형을 식별합니다. 가능한 반환 값은 VSS_COMPONENT_TYPE 설명서를 참조하세요.

[in] wszLogicalPath

복원을 위해 추가할 하위 구성 요소 집합을 포함하는 백업 구성 요소 집합을 정의하는 백업 문서에서 구성 요소의 논리적 경로를 포함하는 Null로 끝나는 와이드 문자열입니다.

이 매개 변수의 값은 NULL일 수 있습니다.

NULL이 아닌 논리 경로에 표시할 수 있는 문자에는 제한이 없습니다.

[in] wszComponentName

복원을 위해 추가할 하위 구성 요소 집합을 포함하는 백업 구성 요소 집합을 정의하는 백업 문서에서 구성 요소의 논리적 경로를 포함하는 Null로 끝나는 와이드 문자열입니다.

이 매개 변수의 값은 NULL일 수 없습니다.

NULL이 아닌 구성 요소 이름에 표시할 수 있는 문자에는 제한이 없습니다.

[in] wszSubComponentLogicalPath

복원을 위해 추가할 하위 구성 요소의 논리적 경로를 포함하는 Null로 끝나는 와이드 문자열입니다.

하위 구성 요소를 추가할 때 논리 경로가 필요합니다. 따라서 이 매개 변수의 값은 NULL일 수 없습니다.

NULL이 아닌 논리 경로에 표시할 수 있는 문자에는 제한이 없습니다.

[in] wszSubComponentName

복원을 위해 추가할 하위 구성 요소의 논리적 이름을 포함하는 Null로 끝나는 와이드 문자열입니다.

이 매개 변수의 값은 NULL일 수 없습니다.

NULL이 아닌 구성 요소 이름에 표시할 수 있는 문자에는 제한이 없습니다.

[in] bRepair

이 매개 변수는 나중에 사용하도록 예약되어 있습니다. 이 매개 변수는 항상 false로 설정해야 합니다 .

반환 값

다음은 이 메서드에 대한 유효한 반환 코드입니다.

값 의미
S_OK
 복원 하위 구성 요소를 추가했습니다.
E_INVALIDARG
 매개 변수 값 중 하나가 잘못되었습니다.
E_OUTOFMEMORY
 호출자가 메모리가 부족하거나 다른 시스템 리소스가 부족합니다.
VSS_E_BAD_STATE
 백업 구성 요소 개체가 초기화되지 않았거나, 복원 작업 중에 이 메서드가 호출되지 않았거나, 이 메서드가 올바른 시퀀스 내에서 호출되지 않았습니다.
VSS_E_INVALID_XML_DOCUMENT
 XML 문서가 잘못되었습니다. 자세한 내용은 이벤트 로그를 확인합니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요.
VSS_E_OBJECT_NOT_FOUND
 구성 요소가 없습니다.
VSS_E_UNEXPECTED
 예기치 않은 오류입니다. 오류 코드가 오류 로그 파일에 기록됩니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 값은 Windows Server 2008 R2 및 Windows 7까지 지원되지 않습니다. E_UNEXPECTED 대신 사용됩니다.

설명

AddRestoreSubcomponent를 호출하기 전에 먼저 IVssBackupComponents::SetSelectedForRestore를 사용하여 복원을 위해 wszLogicalPath 및 wszComponentName 매개 변수로 정의된 루트 구성 요소를 선택해야 합니다.

요청자가 하위 구성 요소 복원을 지원하는 경우 IVssBackupComponents::P reRestore 전에 이 메서드를 호출해야 합니다.

AddRestoreSubcomponent 는 기록기 구성 요소 집합의 모든 파일을 한 단위로 백업해야 하지만 선택한 파일(하위 구성 요소)을 개별적으로 복원할 수 있는 것이 바람직한 경우를 위한 것입니다.

이러한 복원에 참여하려면 하위 구성 요소에 VSS_COMPONENTINFO bSelectableForRestore 멤버가 TRUE로 설정되어 있어야 합니다. wszLogicalPath 및 wszComponentName 매개 변수로 정의된 구성 요소도 IVssBackupComponents::SetSelectedForRestore를 사용하여 복원하도록 선택해야 합니다.

자세한 내용은 복원 및 하위 구성 요소에 대한 선택 가능성 작업을 참조하세요 .

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 vsbackup.h(VsBackup.h, Vss.h, VsWriter.h 포함)
라이브러리 VssApi.lib

추가 정보

IVssBackupComponents

IVssBackupComponents::P reRestore

VSS_COMPONENT_TYPE