JetBeginExternalBackupInstance 함수
적용 대상: Windows | Windows Server
JetBeginExternalBackupInstance 함수
JetBeginExternalBackupInstance 함수는 엔진과 데이터베이스가 온라인 상태이고 활성 상태인 동안 외부 백업을 시작합니다.
Windows XP: JetBeginExternalBackupInstance 가 Windows XP에 도입되었습니다.
JET_ERR JET_API JetBeginExternalBackupInstance(
__in JET_INSTANCE instance,
__in JET_GRBIT grbit
);
매개 변수
instance
이 호출에 사용할 데이터베이스 instance.
Windows 2000의 경우 instance 하나만 지원되므로 이 매개 변수를 허용하는 API 변형을 사용할 수 없습니다. 이 하나의 전역 instance 사용하는 것은 이 경우에 암시됩니다.
Windows XP 이상 릴리스의 경우 이 매개 변수를 허용하지 않는 API 변형은 엔진이 하나의 instance 지원되는 레거시 모드(Windows 2000 호환 모드)에 있을 때만 호출될 수 있습니다. 그렇지 않으면 JET_errRunningInMultiInstanceMode 작업이 실패합니다.
grbit
다음 옵션 중 0개 이상을 지정하는 비트 그룹입니다.
값 |
의미 |
---|---|
JET_bitBackupAtomic |
이 플래그는 더 이상 사용되지 않습니다. 이 비트를 사용하면 JET_errInvalidgrbit 반환됩니다. |
JET_bitBackupIncremental |
전체 백업이 아닌 증분 백업을 만듭니다. 즉, 마지막 전체 또는 증분 백업 이후의 로그 파일만 백업됩니다. |
JET_bitBackupSnapshot |
다음에 사용하도록 예약됩니다. Windows XP에 대해 정의됩니다. |
반환 값
시스템은 이 함수에 대한 호출의 결과로 성공 또는 실패 코드를 생성할 수 있습니다. 이 API에 대한 전체 오류 목록은 확장 가능한 스토리지 엔진 오류 코드를 참조하세요.
JetBeginExternalBackup을 참조하세요.
설명
JetBeginExternalBackupInstance 는 성공적인 온라인(VSS 기반이 아닌) 백업을 실행하기 위해 호출해야 하는 일련의 함수 중 첫 번째 함수입니다. JetBeginExternalBackup 및 JetStopBackupInstance도 참조하세요.
외부 백업을 사용하여 전체, 증분 또는 차등 백업을 구현할 수 있습니다.
백업은 트랜잭션 기록에서 단일 시점과 일치하지만 정확한 시점 제어는 현재 불가능하기 때문에 유사합니다.
요구 사항
요구 사항 | 값 |
---|---|
클라이언트 |
Windows Vista, Windows XP 또는 Windows 2000 Professional이 필요합니다. |
서버 |
Windows Server 2008, Windows Server 2003 또는 Windows 2000 Server가 필요합니다. |
머리글 |
Esent.h에서 선언되었습니다. |
라이브러리 |
ESENT.lib를 사용합니다. |
DLL |
ESENT.dll 필요합니다. |
참고 항목
JET_ERR
JET_GRBIT
JET_INSTANCE
JetAttachDatabase
JetBeginExternalBackup
JetCloseFile
JetEndExternalBackup
JetEndExternalBackupInstance2
JetGetAttachInfo
JetGetLogInfo
JetOpenFile
JetReadFile
JetStopBackup
JetTruncateLog