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

OnBackupShutdown 메서드는 BackupShutdown 이벤트 다음에 기록기에 의해 호출됩니다. 백업 애플리케이션이 종료될 때, 특히 백업 애플리케이션이 충돌하는 경우 필요한 것으로 간주되는 작업을 수행하는 데 사용됩니다.

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

구문

bool OnBackupShutdown(
  [in] VSS_ID SnapshotSetId
);

매개 변수

[in] SnapshotSetId

백업 작업과 관련된 섀도 복사본 집합의 식별자입니다.

반환 값

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

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

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

설명

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

백업 애플리케이션이 종료될 때 기록기에서 특수 작업을 수행해야 하는 경우 기본 구현을 재정의할 수 있습니다.

섀도 복사본이 성공적으로 수행되지 않은 경우 섀도 복사본 집합 식별자(SnapshotSetId)의 값은 NULL이 됩니다.

BackupShutdown 이벤트는 백업 애플리케이션이 실제로 종료되고 해당 IVssBackupComponents 가 해제될 때마다 생성됩니다.

BackupComplete 이벤트를 사용하려면 백업 애플리케이션이 백업을 성공적으로 완료하거나 정상적으로 실패해야 합니다. 백업 애플리케이션이 시스템에 의해 종료되거나 백업이 완료되기 전에 수동으로 종료되는 경우에는 그렇지 않을 수 있습니다(instance 경우 백업 작업이 중단되고 종료되어야 하는 경우).

이 때문에 BackupShutdown 이벤트는 BackupComplete 이벤트보다 백업 애플리케이션 종료에 대한 더 강력한 신호입니다.

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

OnBackupShutdown의 기록기별 구현은 BackupComplete 이벤트가 처리되었는지 여부를 검사 합니다. 백업 후 필요한 모든 기록기 정리 작업(성공 또는 기타)이 미리 구성되었는지 확인해야 합니다.

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

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

요구 사항

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

추가 정보

CVssWriter

CVssWriter::OnBackupComplete

CVssWriter::SetWriterFailure

IVssBackupComponents::BackupComplete