JetTruncateLog 함수

  • 아티클

적용 대상: Windows | Windows Server

JetTruncateLog 함수

JetTruncateLog 함수는 현재 백업이 성공적으로 완료되면 더 이상 필요하지 않은 트랜잭션 로그 파일을 삭제하기 위해 JetBeginExternalBackup에서 시작하는 백업 중에 사용됩니다.

    JET_ERR JET_API JetTruncateLog(void);

매개 변수

이 함수에는 매개 변수가 없습니다.

반환 값

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

반환 코드

설명

JET_errSuccess

작업이 성공적으로 완료되었습니다.

JET_errBackupAbortByServer

현재 외부 백업이 JetStopBackup 호출에 의해 중단되었기 때문에 작업이 실패했습니다.

Windows Server 2003: 이 반환 값은 Windows Server 2003에서 도입되었습니다.

JET_errClientRequestToStopJetService

JetStopService 호출로 인해 세션과 연결된 instance 모든 작업이 중단되었으므로 작업을 완료할 수 없습니다.

JET_errInstanceUnavailable

세션과 연결된 instance 해당 데이터의 무결성을 보호하기 위해 모든 데이터에 대한 액세스를 해지해야 하는 심각한 오류가 발생하여 작업을 완료할 수 없습니다.

Windows XP: 이 반환 값은 Windows XP에 도입되었습니다.

JET_errInvalidBackupSequence

백업 작업이 시퀀스에서 호출되었기 때문에 실패했습니다. JetTruncateLog는 instance JetOpenFile을 사용하여 만든 미해결 파일 핸들이 있는 경우 이 오류를 반환합니다.

JET_errInvalidParameter

제공된 매개 변수 중 하나에 예기치 않은 값이 포함되어 있거나 여러 매개 변수의 조합으로 예기치 않은 결과가 발생했습니다. 지정된 instance 핸들이 유효하지 않은 경우 JetTruncateLog에서 이 문제가 발생할 수 있습니다.

Windows XP: 이 반환 값은 Windows XP에 도입되었습니다.

JET_errNoBackup

외부 백업이 진행 중이 아니므로 작업이 실패했습니다.

JET_errNotInitialized

세션과 연결된 instance 아직 초기화되지 않았기 때문에 작업을 완료할 수 없습니다.

JET_errRestoreInProgress

세션과 연결된 instance 복원 작업이 진행 중이므로 작업을 완료할 수 없습니다.

JET_errRunningInMultiInstanceMode

실제로 여러 인스턴스가 이미 있는 경우 하나의 instance만 지원되는 레거시 모드(Windows 2000 호환 모드)에서 엔진을 사용하려고 했기 때문에 작업이 실패했습니다.

JET_errTermInProgress

세션과 연결된 instance 종료 중이므로 작업을 완료할 수 없습니다.

이 함수가 성공하면 현재 백업이 성공적으로 완료되면 더 이상 필요하지 않은 트랜잭션 로그 파일 집합이 삭제됩니다. 데이터베이스 파일의 백업이 더 이상 허용되지 않게 백업 상태 컴퓨터가 고급 상태가 됩니다. 이 시점 이후 백업을 위해 데이터베이스 패치 파일 및 트랜잭션 로그 파일만 열 수 있습니다.

이 함수가 실패하면 데이터베이스 파일의 백업이 더 이상 허용되지 않게 백업 상태 컴퓨터를 고급으로 설정할 수 있습니다. 원하는 수보다 작은 일부 트랜잭션 로그 파일은 삭제될 수 있지만 항상 가장 오래된 파일에서 가장 어린 파일로 삭제됩니다.

요구 사항

요구 사항 값

클라이언트

Windows Vista, Windows XP 또는 Windows 2000 Professional이 필요합니다.

서버

Windows Server 2008, Windows Server 2003 또는 Windows 2000 Server가 필요합니다.

머리글

Esent.h에서 선언되었습니다.

라이브러리

ESENT.lib를 사용합니다.

DLL

ESENT.dll 필요합니다.

참고 항목

확장 가능한 스토리지 엔진 파일
JetBeginExternalBackup
JET_ERR
JET_INSTANCE
JetOpenFile
JetStopBackup
JetStopService