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