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로 끝나는 와이드 문자열입니다.
반환 값
다음은 이 메서드에 대한 유효한 반환 코드입니다.
| 값 | 의미 |
|---|---|
|
새 복원 대상을 추가했습니다. |
|
매개 변수 값 중 하나가 잘못되었습니다. |
|
호출자가 메모리가 부족하거나 다른 시스템 리소스가 부족합니다. |
|
백업 구성 요소 개체가 초기화되지 않았거나 복원 작업 중에 이 메서드가 호출되지 않았습니다. |
|
구성 요소가 없거나 경로 및 파일 사양이 구성 요소의 구성 요소 및 파일 사양과 일치하지 않습니다. |
|
XML 문서가 잘못되었습니다. 자세한 내용은 이벤트 로그를 확인합니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요. |
|
예기치 않은 오류입니다. 오류 코드가 오류 로그 파일에 기록됩니다. 자세한 내용은 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 |