JetEndExternalBackupInstance2 함수
적용 대상: Windows | Windows Server
JetEndExternalBackupInstance2 함수
JetEndExternalBackupInstance2 함수는 외부 백업 세션을 종료합니다. 이 API는 성공적인 온라인(비 VSS 기반) 백업을 실행하기 위해 호출해야 하는 일련의 API 중 마지막 API입니다.
Windows XP: JetEndExternalBackupInstance2 는 Windows XP에 도입되었습니다.
JET_ERR JET_API JetEndExternalBackupInstance2(
__in JET_INSTANCE instance,
__in JET_GRBIT grbit
);
매개 변수
instance
이 호출에 사용할 instance.
Windows 2000: Windows 2000의 경우 instance 하나만 지원되므로 이 매개 변수를 허용하는 API 변형을 사용할 수 없습니다. 이 하나의 전역 instance 사용하는 것은 이 경우에 암시됩니다.
Windows XP: Windows XP 이상 릴리스의 경우 이 매개 변수를 허용하지 않는 API 변형은 엔진이 하나의 instance 지원되는 레거시 모드(Windows 2000 호환 모드)에 있는 경우에만 호출할 수 있습니다. 그렇지 않으면 작업이 JET_errRunningInMultiInstanceMode 함께 실패합니다.
grbit
다음 옵션 중 0개 이상을 지정하는 비트 그룹입니다.
값 |
의미 |
|---|---|
JET_bitBackupEndAbort |
클라이언트 애플리케이션이 백업을 중단합니다. |
JET_bitBackupEndNormal |
클라이언트 애플리케이션이 백업을 완전히 완료했으며 정상적으로 종료됩니다. |
JET_bitBackupTruncateDone |
Windows Vista: JET_bitBackupTruncateDone Windows Vista에 도입되었습니다. 자르기 호출이 완료되지 않았더라도 엔진은 데이터베이스 헤더를 적절하게 표시할 수 있습니다(예: 전체 백업이 완료됨). |
반환 값
이 함수는 다음 반환 코드 중 하나를 사용하여 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 필요합니다. |
참고 항목
오류 처리 매개 변수
확장 가능한 스토리지 엔진 오류
JET_ERR
JET_GRBIT
JetAttachDatabase
JetBeginExternalBackup
JetBeginExternalBackupInstance
JetCloseFile
JetExternalRestore
JetGetAttachInfo
JetGetLogInfo
JET_INSTANCE
JetOpenFile
JetReadFile
JetStopBackup
JetStopService
JetTruncateLog
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기