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

아티클
08/27/2023

OnAbort 메서드는 VSS에서 발급한 Abort 이벤트에 따라 기록기에서 호출되며, 이는 섀도 복사 작업이 조기에 종료되었음을 나타냅니다. 작성기는 이 메서드를 사용하여 해당 작업에 참여하려는 시도에서 클린.

OnAbort 는 순수 가상 메서드입니다. CVssWriter 기본 클래스에서 구현되지 않으며 파생 클래스에서 구현해야 합니다.

구문

bool OnAbort();

반환 값

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

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

설명

이 메서드에서 작성기는 VSS 작업에 참여할 준비를 할 때 만든 모든 임시 시스템 리소스를 해제해야 합니다.

작성기는 CVssWriter::OnAbort 가 실행된 후 참여했던 VSS 작업과 관련된 추가 이벤트 알림을 받지 않습니다.

작성기가 CVssWriter::OnPostSnapshot 을 호출한 경우(즉, 섀도 복사본의 끝에 대한 알림을 받은 경우) 이 메서드가 호출되지 않습니다.

Abort 이벤트는 다음과 같은 경우에 생성됩니다.

기록기의 Freeze 및 Thaw 이벤트 처리기(CVssWriter::OnFreeze 및 CVssWriter::OnThaw)는 false를 반환하거나 CVssWriter::Initialize에 지정된 시간 창에서 완료할 수 없습니다.
요청자는 IVssBackupComponents::AbortBackup을 호출하여 Abort 이벤트를 명시적으로 생성합니다.
PrepareForSnapshot 이벤트 이후 섀도 복사본을 만드는 동안 공급자 또는 VSS가 실패합니다.

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

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

요구 사항

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