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

OnPreRestore 메서드는 PreRestore 이벤트 다음에 기록기에 의해 호출됩니다. 이 메서드는 instance 데이터베이스 서비스를 오프라인으로 전환하여 복원을 지원하는 상태로 작성기를 배치하고 파일을 복원하는 요청자의 백업 구성 요소 문서에서 수정하는 데 사용됩니다(예: 원래 복원 방법을 재정의하도록 복원 대상 설정).

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

구문

bool OnPreRestore(
  [in] IVssWriterComponents *pComponent
);

매개 변수

[in] pComponent

요청자의 백업 구성 요소 문서에서 현재 작성기와 연결된 구성 요소를 포함하는 IVssWriterComponents 개체의 인스턴스화에 대한 포인터입니다.

반환 값

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

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

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

설명

PreRestore 이벤트는 백업된 데이터가 실제로 복원되기 전에 발생합니다. 이는 작성자가 복원할 항목을 결정할 수 있는 기회입니다.

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

이 메서드를 사용하면 기록기에서 복원할 내용을 확인하고, 저장된 백업 구성 요소 문서에서 저장된 프라이빗 메타데이터를 검색하고, 해당 데이터를 업데이트할 수 있습니다.

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

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

요구 사항

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

추가 정보

CVssWriter

CVssWriter::OnPostSnapshot

CVssWriter::OnPrepareBackup

CVssWriter::SetWriterFailure

IVssWriterComponents