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

  • 아티클

GetDirectedTarget 메서드는 백업 시 기록기에서 저장한 정보를 백업 구성 요소 문서에 반환하여 파일을 복원할 때 파일(원본 파일)을 다시 매핑해야 함을 나타냅니다. 파일은 복원 대상을 사용하여 다른 위치로 복원된 새 복원 대상 및/또는 해당 데이터의 범위로 복원될 수 있습니다.

작성기 또는 요청자는 이 메서드를 호출할 수 있습니다.

구문

HRESULT GetDirectedTarget(
  [in]  UINT iDirectedTarget,
  [out] BSTR *pbstrSourcePath,
  [out] BSTR *pbstrSourceFileName,
  [out] BSTR *pbstrSourceRangeList,
  [out] BSTR *pbstrDestinationPath,
  [out] BSTR *pbstrDestinationFilename,
  [out] BSTR *pbstrDestinationRangeList
);

매개 변수

[in] iDirectedTarget

지시된 대상의 인덱스 번호입니다. 이 매개 변수의 값은 0에서 n-1까지의 정수입니다. 여기서 n 은 지정된 구성 요소와 연결된 총 지시 대상 수(구성 요소 집합을 정의하는 경우 해당 하위 구성 요소)입니다. n 값은 IVssComponent::GetDirectedTargetCount에서 반환됩니다.

[out] pbstrSourcePath

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

[out] pbstrSourceFileName

복원 중에 다시 매핑할 파일(원본 파일)의 이름을 포함하는 문자열을 수신하는 호출자 할당 변수의 주소입니다. 이 파일의 이름은 와일드카드 문자를 포함하지 않아야 하며 원본 경로(pbstrSourcePath)와 동일한 파일 집합의 멤버여야 합니다.

[out] pbstrSourceRangeList

원본 파일 지원 범위(복원할 파일의 섹션)를 나타내는 쉼표로 구분된 파일 오프셋 목록과 길이가 포함된 문자열을 수신하는 호출자 할당 변수의 주소입니다.

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

[out] pbstrDestinationPath

복원 시 원본 파일 데이터가 다시 매핑되는 경로를 포함하는 문자열을 수신하는 호출자가 할당한 변수의 주소입니다.

[out] pbstrDestinationFilename

복원 시 원본 파일 데이터를 다시 매핑할 파일의 이름을 포함하는 문자열을 수신하는 호출자 할당 변수의 주소입니다.

[out] pbstrDestinationRangeList

대상 파일 지원 범위(원본 파일의 섹션을 복원할 위치)를 나타내는 쉼표로 구분된 파일 오프셋 목록과 길이가 포함된 문자열을 수신하는 호출자 할당 변수의 주소입니다.

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

반환 값

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

값 의미
S_OK
 특성 값을 반환했습니다.
E_INVALIDARG
 매개 변수 값 중 하나가 잘못되었습니다.
E_OUTOFMEMORY
 호출자가 메모리가 부족하거나 다른 시스템 리소스가 부족합니다.
VSS_E_INVALID_XML_DOCUMENT
 XML 문서가 잘못되었습니다. 자세한 내용은 이벤트 로그를 확인합니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요.
VSS_E_OBJECT_NOT_FOUND
 지정된 항목을 찾을 수 없습니다.

설명

GetDirectedTarget 호출에 성공하면 호출자는 SysFreeString 함수를 호출하여 반환된 각 문자열의 해제를 담당합니다.

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

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

GetDirectedTarget에서 지시된 대상이 반환되는 파일은 현재 구성 요소의 파일 멤버이거나 정의하는 하위 구성 요소일 수 있습니다.

호출자는 sysFreeString을 호출하여 pbstrSourcePath, pbstrSourceFileName, pbstrSourceRangeList, pbstrDestinationPath, pbstrDestinationFilename 및 pbstrDestinationRangeList 매개 변수가 보유한 메모리를 해제해야 합니다.

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

요청자는 복원을 올바르게 구현하기 위해 지시된 대상 원본 파일이 부분 파일로 백업된 경우 검사 합니다. 이 경우 요청자는 부분 파일 정보(IVssComponent::GetPartialFile)와 함께 지시된 대상 정보를 사용하여 복원하는 동안 백업된 데이터의 다시 매핑을 구현합니다.

요구 사항

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

추가 정보

IVssComponent

IVssComponent::AddDirectedTarget

IVssComponent::GetDirectedTargetCount