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

  • 아티클

AddPartialFile 메서드는 지정된 파일의 일부만 백업해야 하며 해당 부분만 백업해야 함을 나타냅니다.

기록기만 이 메서드를 호출할 수 있으며 백업 작업 중에만 호출할 수 있습니다.

구문

HRESULT AddPartialFile(
  [in] LPCWSTR wszPath,
  [in] LPCWSTR wszFilename,
  [in] LPCWSTR wszRanges,
  [in] LPCWSTR wszMetadata
);

매개 변수

[in] wszPath

부분 파일 작업과 관련된 파일의 경로를 포함하는 Null로 종료된 와이드 문자열입니다.

경로에는 환경 변수(예: %SystemRoot%)가 포함될 수 있지만 와일드카드 문자를 포함할 수는 없습니다.

경로가 백슬래시("")로 끝나야 하는 요구 사항은 없습니다. 검사 이 정보를 검색하는 것은 애플리케이션에 달려 있습니다.

이 경로는 구성 요소에 이미 있는 파일 집합의 경로와 일치하거나 아래에 있어야 합니다(또는 구성 요소가 구성 요소 집합을 정의하는 경우 해당 하위 구성 요소 중 하나).

[in] wszFilename

부분 파일 작업에 관련된 파일의 이름을 포함하는 Null로 끝나는 와이드 문자열입니다. 파일 이름(wszFilename)은 와일드카드 문자(* 또는 ?)를 포함할 수 없으며 원본 경로(wszPath)를 포함하는 파일 집합의 파일 사양과 일치해야 합니다.

[in] wszRanges

부분 파일 지원 범위(실제로 백업할 파일의 섹션) 또는 이러한 목록을 포함하는 파일 오프셋 및 길이 목록을 포함하는 Null로 끝나는 와이드 문자열입니다.

부분 파일 지원 범위를 지정해야 하며 이 값은 NULL일 수 없습니다.

[in] wszMetadata

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

추가 메타데이터가 필요하지 않은 경우 이 값은 NULL일 수 있습니다.

반환 값

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

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

설명

작성자만 이 메서드를 호출할 수 있으며 작성기는 복원 작업 중에 이 메서드를 호출할 수 없습니다.

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

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

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

  1. 백업해야 하는 고유 파일 범위 수를 나타내는 64비트 정수
  2. 64비트 정수 쌍으로 표현되는 각 범위: 백업되는 파일에 대한 오프셋(바이트) 및 백업할 오프셋부터 시작하는 데이터 길이
두 경우 모두 범위는 파일의 나머지 부분과 관계없이 백업할 지정된 파일의 하위 섹션을 나타냅니다.

요청자는 IVssComponent::GetPartialFile 을 사용하여 부분 파일 정보를 검색하고 GetPartialFile 에서 반환된 오프셋 및 길이 정보를 사용하여 복원 시 디스크에 있는 파일의 복사본 내에 있는 적절한 위치로 백업된 섹션을 복원할 수 있습니다.

AddPartialFile 은 구성 요소에서 이미 관리되는 파일(또는 구성 요소가 구성 요소 집합을 정의하는 경우 해당 하위 구성 요소 중 하나)에 적용하거나 구성 요소에 새 파일을 추가하고 부분 파일 작업에 참여함을 나타낼 수 있습니다.

참여할 파일이 새 파일임을 나타내는 경우 해당 파일은 섀도 복사 볼륨에 있어야 하며 해당 경로(wszPath)는 구성 요소에 이미 있는 경로(또는 구성 요소가 구성 요소 집합을 정의하는 경우 해당 하위 구성 요소 중 하나)와 일치하거나 아래에 있어야 합니다. 그러나 파일의 파일 사양(wszFileSpec)은 구성 요소의 사양과 일치하지 않아야 합니다.

새로 추가된 파일은 대체 위치 매핑을 지원하지 않습니다.

요구 사항

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

추가 정보

IVssBackupComponents::SetRangesFilePath

IVssComponent

IVssComponent::GetPartialFile

IVssComponent::GetPartialFileCount