Share via


IVssComponentEx::SetPrepareForBackupFailureMsg 메서드(vswriter.h)

구성 요소에 대한 PrepareForBackup 실패 메시지 문자열을 설정합니다.

이 메서드는 기록기의 CVssWriter::OnPrepareBackup 메서드에서만 호출할 수 있습니다.

구문

HRESULT SetPrepareForBackupFailureMsg(
  [in] LPCWSTR wszFailureMsg
);

매개 변수

[in] wszFailureMsg

PrepareForBackup 이벤트를 처리하는 동안 발생한 오류를 설명하는 오류 메시지를 포함하는 호출자가 할당한 NULL로 종료된 와이드 문자열의 주소입니다.

반환 값

다음은 이 메서드에 대한 유효한 반환 코드입니다.

의미
S_OK
실패 메시지가 성공적으로 설정되었습니다.
E_INVALIDARG
매개 변수 값 중 하나가 잘못되었습니다.
E_OUTOFMEMORY
호출자가 메모리가 부족하거나 다른 시스템 리소스가 부족합니다.
VSS_E_BAD_STATE
이 메서드는 기록기의 CVssWriter::OnPrepareBackup 메서드에서 호출되지 않았습니다.

설명

SetPrepareForBackupFailureMsg로 설정된 오류 메시지는 구성 요소의 모든 파일 및 하위 구성 요소에 적용됩니다.

요구 사항

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

추가 정보

CVssWriter::OnPrepareBackup

IVssComponentEx

IVssComponentEx::GetPrepareForBackupFailureMsg