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