CVssWriter::OnPostRestore 메서드(vswriter.h)

  • 아티클

OnPostRestore 메서드는 PostRestore 이벤트 다음에 기록기에 의해 호출됩니다. 요청자가 파일을 디스크로 복원한 후 필요한 것으로 간주되는 작업을 수행하는 데 사용됩니다. 그러나 이러한 작업은 백업 구성 요소 문서를 수정할 수 없습니다.

OnPostRestore 는 가상 메서드입니다. CVssWriter 기본 클래스에 의해 구현되지만 파생 클래스에서 재정의할 수 있습니다.

구문

bool OnPostRestore(
  [in] IVssWriterComponents *pComponent
);

매개 변수

[in] pComponent

작성기의 구성 요소 정보에 대한 액세스 권한을 메서드에 제공하기 위해 VSS에서 전달한 IVssWriterComponents 개체에 대한 포인터입니다. 요청자가 구성 요소를 지원하지 않는 경우 이 매개 변수의 값은 NULL 일 수 있습니다( CVssWriter::AreComponentsSelected 가 false를 반환하는 경우).

반환 값

기본 클래스에서 구현한 대로 OnPostRestore 는 항상 true를 반환 합니다.

이 메서드의 다른 구현은 심각한 오류의 경우를 제외하고 true 를 반환해야 합니다. 심각한 오류가 발생하는 경우 메서드는 CVssWriter::SetWriterFailure 메서드를 호출하여 false를 반환하기 전에 실패에 대한 설명을 제공해야 합니다. 심각하지 않은 오류가 발생하는 경우 메서드는 여전히 SetWriterFailure 를 호출하지만 true를 반환해야 합니다. 일시적인 문제로 인해 오류가 발생하는 경우 메서드는 SetWriterFailure 호출에서 VSS_E_WRITERERROR_RETRYABLE 지정해야 합니다.

오류가 발생하는 모든 경우 메서드는 이벤트 로그에 이벤트를 작성하여 오류의 정확한 이유를 보고해야 합니다.

설명

CVssWriter 기본 클래스에 의한 이 메서드의 기본 구현은 다른 작업을 수행하지 않고 true를 반환합니다.

필요한 경우 기록기는 임시 파일을 제거하고 복원에 참여하는 데 필요한 시스템 리소스를 해제해야 합니다.

기록기는 이 메서드 또는 다른 CVssWriter(Ex)::OnXxx 콜백 메서드에서 예외를 throw해서는 안 됩니다.

PostRestore 이벤트가 생성되면 요청자의 Backup 구성 요소 문서가 읽기 전용 문서가 됩니다. 따라서 인터페이스를 통해 문서를 수정하려고 시도합니다(instance 경우 IVssComponent::SetRestoreMetadata 호출)는 OnPostRestore의 사용자 구현에서 실패합니다.

이 메서드가 CVssWriterEx2::GetSessionId, CVssWriter::SetWriterFailure 또는 CVssWriterEx2::SetWriterFailureEx 메서드를 호출하는 경우 이 메서드를 호출한 동일한 스레드에서 호출해야 합니다. 자세한 내용은 기록기 이벤트 처리를 참조하세요.

요구 사항

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

추가 정보

CVssWriter

IVssWriterComponents