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).
반환 값
다음은 이 메서드에 대한 유효한 반환 코드입니다.
| 값 | 의미 |
|---|---|
|
특성 값을 반환했습니다. |
|
매개 변수 값 중 하나가 잘못되었습니다. |
|
호출자가 메모리가 부족하거나 다른 시스템 리소스가 부족합니다. |
|
호출자가 작업에 대한 올바른 상태(백업 또는 복원)에 있지 않습니다. |
|
XML 문서가 잘못되었습니다. 자세한 내용은 이벤트 로그를 확인합니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요. |
|
지정한 항목을 찾을 수 없습니다. |
설명
호출자는 SysFreeString을 호출하여 pbstrPath, pbstrFilename, pbstrRange 및 pbstrMetadata 매개 변수가 보유한 메모리를 해제해야 합니다.
범위는 파일의 나머지 부분과 관계없이 백업할 지정된 파일의 하위 섹션을 나타냅니다.
범위 목록(pbstrRanges)의 구문은 offset1:length1, offset2:length2 형식의 쉼표로 구분된 목록의 구문입니다. 여기서 각 오프셋과 길이는 각각 바이트 오프셋과 길이(바이트)를 지정하는 64비트 정수입니다. 오프셋과 길이는 16진수 또는 10진수 값으로 표현할 수 있습니다.
pbstrRanges가 모든 오프셋 및 길이(범위 파일)를 포함하는 파일을 참조하는 경우 pbstrRanges는 파일에 대한 전체 경로를 포함해야 합니다.
wszRange가 모든 오프셋 및 길이(범위 파일)를 포함하는 파일을 참조하는 경우 wszRange는 파일에 대한 전체 경로를 포함해야 합니다.
범위 파일은 다음 형식의 이진 파일이어야 합니다.
- 백업해야 하는 고유 파일 범위의 수를 나타내는 64비트 정수입니다.
- 64비트 정수 쌍으로 표현되는 각 범위: 백업 중인 파일의 오프셋(바이트) 및 백업할 오프셋부터 시작하는 데이터의 길이입니다.
그러나 범위 파일이 복원되는 위치는 요청자가 변경할 수 있습니다. 요청자는 IVssBackupComponents::SetRangesFilePath 를 사용하여 이를 나타내고 pbstrRanges 가 올바른 범위 파일을 나타내도록 백업 구성 요소 문서를 업데이트합니다.
요청자는 GetPartialFile 에서 반환된 범위 정보를 사용하여 백업된 섹션을 복원 시 디스크에 있는 파일 복사본 내의 적절한 위치로 복원합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | vswriter.h(Vss.h, VsWriter.h 포함) |
| 라이브러리 | VssApi.lib |