JetTerm 함수
적용 대상: Windows | Windows Server
JetTerm 함수
JetTerm 함수는 JetInit에서 초기화한 instance 종료를 시작합니다.
JetTerm을 사용하여 JetCreateInstance에서 만든 초기화되지 않은 instance 파괴할 수도 있습니다.
JET_ERR JET_API JetTerm(
__in JET_INSTANCE instance
);
매개 변수
instance
이 호출에 사용할 instance 지정합니다.
Windows 2000: 이 매개 변수는 무시되며 항상 NULL이어야 합니다.
Windows XP 이상 릴리스: 이 매개 변수는 오버로드됩니다. 엔진이 하나의 instance 지원되는 레거시 모드(Windows 2000 호환 모드)에서 작동하는 경우 이 매개 변수는 NULL이거나 JetInit에서 반환되는 실제 instance 포함할 수 있습니다. 엔진이 다중 instance 모드에서 작동하는 경우 이 매개 변수는 JetCreateInstance를 사용하여 만든 instance 대한 포인터여야 합니다.
반환 값
이 함수는 다음 반환 코드 중 하나를 사용하여 JET_ERR 데이터 형식을 반환합니다. 가능한 ESE 오류에 대한 자세한 내용은 확장 가능한 스토리지 엔진 오류 및 오류 처리 매개 변수를 참조하세요.
반환 코드 |
설명 |
|---|---|
JET_errSuccess |
작업이 성공적으로 완료되었습니다. |
JET_errInvalidParameter |
제공된 매개 변수 중 하나에 예기치 않은 값이 포함되어 있거나 여러 매개 변수의 조합으로 예기치 않은 결과가 발생했습니다. 이 오류는 엔진이 다중 instance 모드이고 핀스탄스가 잘못된 instance 참조하는 경우 JetTerm에서 반환됩니다. Windows XP: 이 반환 값은 Windows XP에 도입되었습니다. |
JET_errNotInitialized |
instance 아직 초기화되지 않았으므로 작업을 완료할 수 없습니다. |
JET_errTermInProgress |
instance 종료 중이므로 작업을 완료할 수 없습니다. |
JET_errRestoreInProgress |
instance 복원 작업이 진행 중이므로 작업을 완료할 수 없습니다. |
JET_errBackupInProgress |
instance 백업 작업이 진행 중이므로 작업을 완료할 수 없습니다. |
JET_errTooManyActiveUsers |
현재 지정된 instance 대한 활성 트랜잭션이 있는 세션이 있으므로 instance 종료할 수 없습니다. 이 오류는 JET_bitTermComplete 사용되는 경우에만 발생합니다. |
이 함수가 성공하면 지정된 instance 종료됩니다. instance 핸들도 닫혀 instance 핸들을 사용하는 모든 API에서 사용할 수 없게 됩니다. 세션과 같이 instance 연결된 다른 모든 개체도 닫힙니다. 검사점 파일, 트랜잭션 로그 파일 및 instance 연결된 데이터베이스 파일의 상태는 종료 프로세스 중에 수정됩니다.
사용 오류로 인해 이 함수가 실패하면 instance 초기화된 상태로 유지되고 아무 것도 변경되지 않습니다. 그렇지 않으면 성공 사례에 따라 instance 여전히 종료됩니다. 차이점은 instance 다음에 초기화될 때 크래시 복구를 거쳐야 한다는 것입니다. 엔진은 필요한 복구 양을 최소화하기 위해 가능한 한 많은 데이터를 플러시하려고 합니다. 개념적으로 JetTerm 의 이러한 실패는 프로세스 충돌과 다르지 않습니다.
설명
해당 instance JetTerm이 성공적으로 호출되기 전에 어떤 이유로든 instance 호스트 프로세스가 종료되면 instance 충돌된 상태로 간주됩니다. 크래시 복구는 해당 instance 초기화하려는 다음 시도에서 발생합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
클라이언트 |
Windows Vista, Windows XP 또는 Windows 2000 Professional이 필요합니다. |
서버 |
Windows Server 2008, Windows Server 2003 또는 Windows 2000 Server가 필요합니다. |
머리글 |
Esent.h에 선언되었습니다. |
라이브러리 |
ESENT.lib를 사용합니다. |
DLL |
ESENT.dll 필요합니다. |
참고 항목
확장 가능한 스토리지 엔진 파일
JetCreateInstance
JET_ERR
JET_GRBIT
JetInit
JET_INSTANCE
JetTerm2