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

  • 아티클

GetPartialFile 메서드는 이 구성 요소와 연결된 부분 파일에 대한 정보를 반환합니다.

구문

HRESULT GetPartialFile(
  [in]  UINT iPartialFile,
  [out] BSTR *pbstrPath,
  [out] BSTR *pbstrFilename,
  [out] BSTR *pbstrRange,
  [out] BSTR *pbstrMetadata
);

매개 변수

[in] iPartialFile

부분 파일의 인덱스 번호입니다. 이 매개 변수의 값은 0에서 n-1 사이의 정수입니다. 여기서 n 은 지정된 구성 요소와 연결된 부분 파일의 총 수입니다. n 값은 IVssComponent::GetPartialFileCount에서 반환됩니다.

[out] pbstrPath

부분 파일의 경로를 포함하는 문자열에 대한 포인터입니다.

이 메서드의 사용자는 이 경로가 백슬래시("")로 끝나는지 여부를 확인하기 위해 검사 합니다.

[out] pbstrFilename

부분 파일의 이름을 포함하는 문자열에 대한 포인터입니다.

[out] pbstrRange

부분 파일 지원 범위(백업된 파일의 섹션)를 구성하는 파일 오프셋 및 길이 목록 또는 이러한 목록을 포함하는 파일의 이름을 포함하는 문자열에 대한 포인터입니다.

[out] pbstrMetadata

기록기에서 부분 파일 복원 작업의 유효성을 검사하는 데 필요한 추가 메타데이터가 포함된 문자열에 대한 포인터입니다. 이 메타데이터 문자열의 정보는 요청자에게 불투명합니다.

추가 메타데이터는 필요하지 않으므로 pbstrMetadata 도 비어 있을 수 있습니다(길이가 0).

반환 값

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

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

설명

호출자는 SysFreeString을 호출하여 pbstrPath, pbstrFilename, pbstrRange 및 pbstrMetadata 매개 변수가 보유한 메모리를 해제해야 합니다.

범위는 파일의 나머지 부분과 관계없이 백업할 지정된 파일의 하위 섹션을 나타냅니다.

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

pbstrRanges가 모든 오프셋 및 길이(범위 파일)를 포함하는 파일을 참조하는 경우 pbstrRanges는 파일에 대한 전체 경로를 포함해야 합니다.

wszRange가 모든 오프셋 및 길이(범위 파일)를 포함하는 파일을 참조하는 경우 wszRange는 파일에 대한 전체 경로를 포함해야 합니다.

범위 파일은 다음 형식의 이진 파일이어야 합니다.

  1. 백업해야 하는 고유 파일 범위의 수를 나타내는 64비트 정수입니다.
  2. 64비트 정수 쌍으로 표현되는 각 범위: 백업 중인 파일의 오프셋(바이트) 및 백업할 오프셋부터 시작하는 데이터의 길이입니다.
범위 파일은 부분 파일과 함께 백업되어야 하며 일반적으로 백업된 위치와 동일한 위치로 복원됩니다.

그러나 범위 파일이 복원되는 위치는 요청자가 변경할 수 있습니다. 요청자는 IVssBackupComponents::SetRangesFilePath 를 사용하여 이를 나타내고 pbstrRanges 가 올바른 범위 파일을 나타내도록 백업 구성 요소 문서를 업데이트합니다.

요청자는 GetPartialFile 에서 반환된 범위 정보를 사용하여 백업된 섹션을 복원 시 디스크에 있는 파일 복사본 내의 적절한 위치로 복원합니다.

요구 사항

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

추가 정보

IVssBackupComponents::SetRangesFilePath

IVssComponent

IVssComponent::AddPartialFile

IVssComponent::GetPartialFileCount