IVssComponentEx2::SetFailure 메서드(vswriter.h)

VSS 작성기는 이 메서드를 호출하여 구성 요소 수준에서 오류를 보고합니다.

구문

HRESULT SetFailure(
  [in] HRESULT hr,
  [in] HRESULT hrApplication,
  [in] LPCWSTR wszApplicationMessage,
  [in] DWORD   dwReserved
);

[in] hr

IVssComponentEx2::GetFailure 메서드를 호출하는 요청자에게 반환될 오류 코드입니다.

다음은 이 메서드가 설정할 수 있는 오류 코드입니다.

값	의미
S_OK	작가는 성공적이었다.
VSS_E_WRITERERROR_INCONSISTENTSNAPSHOT	섀도 복사본에는 애플리케이션 구성 요소를 올바르게 백업하는 데 필요한 볼륨의 하위 집합만 포함됩니다.
VSS_E_WRITERERROR_OUTOFRESOURCES	기록기에 메모리 또는 기타 시스템 리소스가 부족했습니다. 이 오류 코드를 처리하는 권장 방법은 10분을 기다린 다음 작업을 최대 3번 반복하는 것입니다.
VSS_E_WRITERERROR_TIMEOUT	Freeze 및 Thaw 이벤트 간의 시간 제한으로 인해 기록기 작업이 실패했습니다. 이 오류 코드를 처리하는 권장 방법은 10분을 기다린 다음 작업을 최대 3번 반복하는 것입니다.
VSS_E_WRITERERROR_RETRYABLE	전체 백업, 복원 또는 섀도 복사본 만들기 프로세스를 다시 시작한 경우 발생하지 않을 수 있는 오류로 인해 기록기가 실패했습니다. 이 오류 코드를 처리하는 권장 방법은 10분을 기다린 다음 작업을 최대 3번 반복하는 것입니다.
VSS_E_WRITERERROR_NONRETRYABLE	다른 섀도 복사본을 만들 때 발생할 수 있는 오류로 인해 기록기 작업이 실패했습니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요.

[in] hrApplication

요청자에게 반환할 추가 오류 코드입니다. 이 매개 변수는 선택 사항입니다.

[in] wszApplicationMessage

요청자가 최종 사용자에게 표시할 오류 메시지가 포함된 문자열입니다. 작성기는 이 메서드에서 사용하기 전에 필요한 경우 이 문자열을 지역화해야 합니다. 이 매개 변수는 선택 사항이며 NULL 또는 빈 문자열일 수 있습니다.

[in] dwReserved

이 매개 변수는 나중에 사용할 수 있도록 예약되어 있으며 0으로 설정해야 합니다.

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

이 메서드를 호출하는 것 외에도 CVssWriterEx2::SetWriterFailureEx 메서드를 사용하여 부분 기록기 오류가 발생했음을 보고합니다.

이 메서드는 CVssWriter::OnIdentify 또는 CVssWriterEx::OnIdentifyEx에서 호출할 수 없습니다.