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