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

  • 아티클

SetPreviousBackupStamp 메서드는 차등 또는 증분 백업 작업의 기반이 되는 이전 백업 작업의 백업 스탬프를 설정합니다.

메서드는 백업 작업 중에만 호출할 수 있습니다.

구문

HRESULT SetPreviousBackupStamp(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE ct,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] LPCWSTR            wszPreviousBackupStamp
);

매개 변수

[in] writerId

기록기 식별자입니다.

[in] ct

구성 요소의 형식입니다. 가능한 값은 VSS_COMPONENT_TYPE 참조하세요.

[in] wszLogicalPath

구성 요소의 논리적 경로를 포함하는 Null로 끝나는 와이드 문자열입니다.

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

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

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

[in] wszComponentName

구성 요소의 이름을 포함하는 Null로 끝나는 와이드 문자열입니다.

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

[in] wszPreviousBackupStamp

설정할 백업 스탬프입니다.

반환 값

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

값 의미
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 대신 사용됩니다.

설명

IVssBackupComponents::P repareForBackup 전에 이 메서드를 호출해야 합니다.

요청자만 이 메서드를 호출할 수 있습니다.

SetPreviousBackupStamp에서 설정한 백업 스탬프는 구성 요소의 모든 파일과 해당 구성 요소에 있는 선택 불가능한 하위 구성 요소에 적용됩니다.

요청자는 백업 구성 요소 문서에 백업 스탬프만 저장합니다. 백업 스탬프를 직접 사용하고, 형식을 모르며, 생성 방법을 모를 수 없습니다.

따라서 SetPreviousBackupStamp 로 설정된 값은 이전 백업 작업의 저장된 백업 구성 요소 문서에서 검색하거나(올바른 구성 요소에 대해 IVssComponent::GetBackupStamp 사용) 요청자가 자체 내부 레코드에 저장한 정보에서 검색해야 합니다.

그러면 작성기가 이 값을 가져오고( IVssComponent::GetPreviousBackupStamp 사용) 을 사용하면 증분 또는 차등 백업에 참여하기 위해 적절한 파일을 표시할 수 있습니다.

요구 사항

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

추가 정보

IVssBackupComponents

IVssBackupComponents::P reRestore