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 |