JetEndExternalBackupInstance 함수

적용 대상: Windows | Windows Server

JetEndExternalBackupInstance 함수

JetEndExternalBackupInstance 함수는 외부 백업 세션을 종료합니다. 이 API는 성공적인 온라인(VSS 기반이 아닌) 백업을 실행하기 위해 호출해야 하는 일련의 API의 마지막 API입니다.

Windows XP: JetEndExternalBackupInstance 가 Windows XP에 도입되었습니다.

    JET_ERR JET_API JetEndExternalBackupInstance(
      __in          JET_INSTANCE instance
    );

매개 변수

instance

이 호출에 사용할 instance.

Windows 2000: Windows 2000의 경우 instance 하나만 지원되므로 이 매개 변수를 허용하는 API 변형을 사용할 수 없습니다. 이 하나의 전역 instance 사용하는 것은 이 경우에 암시됩니다.

Windows XP: Windows XP 이상 릴리스의 경우 이 매개 변수를 허용하지 않는 API 변형은 엔진이 하나의 instance 지원되는 레거시 모드(Windows 2000 호환 모드)에 있을 때만 호출할 수 있습니다. 그렇지 않으면 JET_errRunningInMultiInstanceMode 작업이 실패합니다.

반환 값

이 함수는 다음 반환 코드 중 하나를 사용하여 JET_ERR 데이터 형식을 반환합니다. 가능한 ESE 오류에 대한 자세한 내용은 확장 가능한 스토리지 엔진 오류 및 오류 처리 매개 변수를 참조하세요.

반환 코드	설명
JET_errSuccess	작업이 성공적으로 완료되었습니다.
JET_errBackupAbortByCaller	Windows XP: 이 반환 값은 Windows XP에 도입되었습니다. 호출자는 JetStopBackup으로 의도를 알리지 않고 백업 시퀀스 중간에 백업을 종료했습니다. 이 오류는 Windows Server 2003 이상의 백업 클라이언트에서 버그가 발생한 결과입니다. Windows XP에서 외부 백업 시퀀스의 의도적인 종료에 대해 이 오류가 반환됩니다.
JET_errBackupAbortByServer	Windows Server 2003: 이 반환 값은 Windows Server 2003에서 도입되었습니다. 현재 외부 백업이 JetStopBackup 호출에 의해 중단되었기 때문에 작업이 실패했습니다.
JET_errClientRequestToStopJetService	JetStopService 호출로 인해 세션과 연결된 instance 모든 작업이 중단되었으므로 작업을 완료할 수 없습니다.
JET_errInstanceUnavailable	Windows XP: 이 반환 값은 Windows XP에 도입되었습니다. 세션과 연결된 instance 해당 데이터의 무결성을 보호하기 위해 모든 데이터에 대한 액세스를 해지해야 하는 심각한 오류가 발생하여 작업을 완료할 수 없습니다.
JET_errNoBackup	외부 백업이 진행 중이 아니므로 작업이 실패했습니다.
JET_errNotInitialized	세션과 연결된 instance 아직 초기화되지 않았기 때문에 작업을 완료할 수 없습니다.
JET_errRestoreInProgress	세션과 연결된 instance 복원 작업이 진행 중이므로 작업을 완료할 수 없습니다.
JET_errRunningInMultiInstanceMode	실제로 여러 인스턴스가 이미 있는 경우 하나의 instance만 지원되는 레거시 모드(Windows 2000 호환 모드)에서 엔진을 사용하려고 했기 때문에 작업이 실패했습니다.
JET_errTermInProgress	세션과 연결된 instance 종료 중이므로 작업을 완료할 수 없습니다.

함수가 성공하면 외부 백업이 성공했습니다. 성공은 백업 유형( JetBeginExternalBackup에 지정됨)에 적합한 모든 파일(예: 데이터베이스 및 로그)이 백업 엔진에서 검색되었음을 나타냅니다. 백업된 파일은 하드 복구(JetExternalRestore)를 사용하여 복구할 수 있습니다.

이 함수가 실패하면 일반적으로 외부 백업이 종료됩니다. 실패는 클라이언트 또는 애플리케이션 사용 오류로 인해 백업이 유효하지 않음을 의미합니다. 백업 시퀀스가 성공했는지 확인하려면 이 API의 반환 코드를 검사 것이 중요합니다.

설명

엔진이 이벤트를 기록하도록 구성된 경우 외부 백업의 확인을 나타내기 위해 이벤트가 기록됩니다.

백업 시퀀스가 순서대로 완료되지 않고 JetEndExternalBackup을 성공적으로 호출하는 경우 후속 증분 백업에는 애플리케이션이 예상한 것보다 더 많은 데이터가 포함될 수 있습니다.

외부 백업 API 시퀀스에 대한 자세한 내용은 JetBeginExternalBackup을 참조하세요.

Windows Vista 이전에 로그 잘림이 수행되지 않은 경우 엔진은 백업이 복사 백업이라고 간주했습니다. 그러나 백업은 잘림이 수행되지 않은 일반적인 백업일 수 있습니다(예: 분리된 데이터베이스가 있는 경우). JET_bitBackupTruncateDone 옵션을 사용하여 엔진에 이를 알리고 적절한 데이터베이스 헤더 수정을 허용할 수 있습니다.

요구 사항

요구 사항	값
클라이언트	Windows Vista 또는 Windows XP가 필요합니다.
서버	Windows Server 2008 또는 Windows Server 2003이 필요합니다.
머리글	Esent.h에서 선언되었습니다.
라이브러리	ESENT.lib를 사용합니다.
DLL	ESENT.dll 필요합니다.

참고 항목

매개 변수 처리 오류
확장 가능한 스토리지 엔진 오류
JetAttachDatabase
JetBeginExternalBackup
JetBeginExternalBackupInstance
JetCloseFile
JET_ERR
JetExternalRestore
JetGetAttachInfo
JetGetLogInfo
JET_INSTANCE
JetOpenFile
JetReadFile
JetStopBackup
JetStopService
JetTruncateLog