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