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

  • 아티클

SetRangesFilePath 메서드는 부분 파일 작업에 범위 파일이 필요하고 해당 파일이 원래 파일이 아닌 다른 위치로 복원된 경우에 사용됩니다.

구문

HRESULT SetRangesFilePath(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE ct,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] UINT               iPartialFile,
  [in] LPCWSTR            wszRangesFile
);

매개 변수

[in] writerId

부분 파일 작업에 관련된 파일을 포함하는 기록기 클래스의 GUID(Globally Unique Identifier)입니다.

[in] ct

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

[in] wszLogicalPath

부분 파일 작업에 참여하는 파일을 포함하는 구성 요소의 논리적 경로를 포함하는 Null로 끝나는 와이드 문자열입니다.

자세한 내용은 구성 요소의 논리적 경로를 참조하세요.

여기서 사용되는 논리 경로를 포함하는 문자열의 값은 IVssBackupComponents::AddComponent를 사용하여 구성 요소가 백업 집합에 추가되었을 때 사용된 것과 동일해야 합니다.

논리 경로는 NULL일 수 있습니다.

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

[in] wszComponentName

부분 파일 작업에 참여하는 파일이 포함된 구성 요소의 이름을 포함하는 Null로 끝나는 와이드 문자열입니다.

문자열은 NULL 일 수 없으며 IVssBackupComponents::AddComponent를 사용하여 구성 요소가 백업 집합에 추가되었을 때 사용된 것과 동일한 구성 요소 이름을 포함해야 합니다.

[in] iPartialFile

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

[in] wszRangesFile

범위 파일의 정규화된 경로를 포함하는 Null로 끝나는 와이드 문자열입니다.

반환 값

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

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

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

설명

범위 파일이 제자리에 복원되는 경우 SetRangesFilePath 를 호출할 필요가 없습니다.

요구 사항

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

추가 정보

IVssBackupComponents

IVssComponent::AddPartialFile

IVssComponent::GetPartialFile

IVssComponent::GetPartialFileCount