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

OnBackupComplete 메서드는 BackupComplete 이벤트 다음에 기록기에 의해 호출됩니다. 백업 후 필요한 것으로 간주되는 작업을 수행하는 데 사용됩니다. 그러나 이러한 작업은 백업 구성 요소 문서를 수정할 수 없습니다.

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

구문

bool OnBackupComplete(
  [in] IVssWriterComponents *pComponent
);

매개 변수

[in] pComponent

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

반환 값

기본 클래스에 의해 구현된 OnBackupComplete 는 항상 true를 반환 합니다.

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

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

설명

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

백업이 끝날 때 작성기에서 특수 작업을 수행하는 경우 기본 구현을 재정의할 수 있습니다.

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

성공적인 백업 애플리케이션은 모든 데이터가 백업 미디어에 저장되면 BackupComplete 이벤트를 생성합니다.

그러나 백업 애플리케이션이 백업을 성공적으로 완료하거나 정상적으로 실패해야 하므로 기록기가 BackupComplete 이벤트 알림을 받을 수 있다는 보장은 없습니다.

백업 애플리케이션이 시스템에 의해 종료되거나 백업이 완료되기 전에 수동으로(백업 작업이 중단되고 종료되어야 하는 경우 instance 경우) BackupComplete 이벤트가 생성되지 않을 수 있습니다.

기록기는 지정된 섀도 복사본 집합에 대해 BackupComplete 이벤트가 전송되었는지 여부를 추적할 수 있도록 상태 정보를 유지 관리해야 합니다.

이 정보는 백업 애플리케이션이 실제로 종료되고 IVssBackupComponents가 릴리스될 때 호출되는 기록기의 BackupShutdown 이벤트 처리기(CVssWriter::OnBackupShutdown)에서 사용할 수 있으며 OnBackupComplete에 대한 호출이 없는 경우 정리 작업을 수행합니다.

기록기는 이 메서드 또는 다른 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::SetWriterFailure

IVssBackupComponents

IVssWriterComponents