IVssComponent::AddDirectedTarget 메서드(vswriter.h)

AddDirectedTarget 메서드를 사용하면 작성기가 복원 시 파일을 복원할 때 파일(원본 파일)을 다시 매핑해야 함을 나타낼 수 있습니다. 파일은 새 복원 위치 및/또는 복원 위치 내의 다른 오프셋으로 복원된 데이터의 범위로 복원할 수 있습니다.

이 메서드는 복원 작업 중에 작성기에서 호출할 수 있습니다.

BackupComplete(CVssWriter::OnBackupComplete) 또는 BackupShutdown(CVssWriter::OnBackupShutdown) 이벤트를 처리하는 동안 이 메서드를 호출할 수 없습니다.

구문

HRESULT AddDirectedTarget(
  [in] LPCWSTR wszSourcePath,
  [in] LPCWSTR wszSourceFilename,
  [in] LPCWSTR wszSourceRangeList,
  [in] LPCWSTR wszDestinationPath,
  [in] LPCWSTR wszDestinationFilename,
  [in] LPCWSTR wszDestinationRangeList
);

매개 변수

[in] wszSourcePath

복원할 파일(원본 파일)이 포함된 복원 시 디렉터리의 경로를 포함하는 Null로 끝나는 와이드 문자열입니다. 이 경로는 구성 요소에 이미 있는 파일 집합의 경로와 일치하거나 아래에 있어야 합니다(또는 구성 요소가 구성 요소 집합을 정의하는 경우 해당 하위 구성 요소 중 하나).

[in] wszSourceFilename

복원 시간(원본 파일)에 다시 매핑될 파일의 이름을 포함하는 Null로 끝나는 와이드 문자열입니다(백업 시). 파일 이름(wszSourceFilename)은 와일드카드 문자(* 또는 ?)를 포함할 수 없으며 원본 경로(wszSourcePath)를 포함하는 파일 집합의 파일 사양과 일치해야 합니다.

[in] wszSourceRangeList

소스 파일 지원 범위(실제로 복원할 파일의 섹션)를 나타내는 쉼표로 구분된 파일 오프셋 목록과 길이를 포함하는 null로 끝나는 와이드 문자열입니다.

원본 파일 지원 범위의 수와 길이는 대상 파일 지원 범위의 수와 크기와 일치해야 합니다.

[in] wszDestinationPath

복원 시 원본 파일 데이터를 다시 매핑할 경로를 포함하는 Null로 끝나는 와이드 문자열입니다.

[in] wszDestinationFilename

복원 시 원본 파일 데이터를 다시 매핑할 파일의 이름을 포함하는 Null로 끝나는 와이드 문자열입니다. 파일 이름(wszDestinationFilename)은 와일드카드 문자(* 또는 ?)를 포함할 수 없습니다.

[in] wszDestinationRangeList

대상 파일 지원 범위(원본 파일의 섹션을 복원할 위치)를 나타내는 쉼표로 구분된 파일 오프셋 및 길이 목록을 포함하는 null로 끝나는 와이드 문자열입니다.

대상 파일 지원 범위의 수와 길이는 원본 파일 지원 범위의 수와 크기와 일치해야 합니다.

반환 값

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

값	의미
S_OK	항목을 설정했습니다.
E_INVALIDARG	매개 변수 값 중 하나가 잘못되었습니다.
E_OUTOFMEMORY	호출자가 메모리가 부족하거나 다른 시스템 리소스가 부족합니다.
VSS_E_BAD_STATE	이 메서드는 기록기에서 호출되지 않았거나 기록기에서 호출한 경우 복원 작업 중에 호출되지 않았거나 BackupComplete 또는 BackupShutdown 이벤트를 처리하는 동안 호출되었습니다.

설명

작성기만 AddDirectedTarget을 호출할 수 있으며 복원 작업 중에만 호출할 수 있습니다.

요청자는 복원 대상이 VSS_RT_DIRECTED 경우에만 백업 구성 요소 문서에 저장된 지시된 대상 정보를 사용합니다.

AddDirectedTarget 메서드는 현재 구성 요소에서 관리되는 모든 파일에 적용하거나 구성 요소가 구성 요소 집합을 정의하는 경우 선택할 수 없는 하위 구성 요소에 적용할 수 있습니다.

원본 및 대상 파일 사양은 동일한 파일을 가리킬 수 있습니다. 이렇게 하면 복원 시 파일을 자체에 다시 매핑할 수 있습니다.

범위 목록(wszSourceRanges 및 wszDestinationRanges)의 구문은 offset1:length1, offset2:length2 형식의 쉼표로 구분된 목록입니다. 여기서 각 오프셋과 길이는 각각 바이트 오프셋과 길이(바이트)를 지정하는 64비트 정수입니다. 오프셋과 길이는 16진수 또는 10진수 값으로 표현할 수 있습니다.

항목 수와 해당 크기는 원본 및 대상 범위 인수에서 일치해야 합니다.

AddDirectedTarget은 구성 요소가 구성 요소 집합을 정의하는 경우 구성 요소 또는 해당 하위 구성 요소 중 하나에서 이미 관리되는 모든 파일을 원본 파일로 사용할 수 있습니다.

백업할 부분 파일 범위가 지시된 대상 원본 범위와 일치하는 경우 부분 파일을 지시된 대상으로 추가할 수 있습니다( IVssComponent::AddPartialFile 참조). 이렇게 하면 복원 시 부분 파일을 다시 매핑할 수 있습니다.

이 경우 요청자는 IVssComponent::GetDirectedTarget 메서드를 호출하여 지시된 대상 정보를 검색하고 이를 사용하여 복원하는 동안 백업된 데이터의 다시 매핑을 구현합니다.

요구 사항

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

추가 정보

IVssComponent

IVssComponent::GetDirectedTarget

IVssComponent::GetDirectedTargetCount