JetEndSession 함수

아티클
06/13/2023

적용 대상: Windows | Windows Server

JetEndSession 함수

JetEndSession 함수는 세션을 종료하고 지정된 세션과 연결된 모든 리소스를 정리하고 할당을 취소합니다.

    JET_ERR JET_API JetEndSession(
      __in          JET_SESID sesid,
      __in          JET_GRBIT grbit
    );

매개 변수

sesid

종료할 세션입니다. 연결된 리소스는 세션이 종료될 때 해제됩니다.

grbit

예약되어 있습니다. 이 매개 변수는 JET_bitForceSessionClosed 플래그를 포함할 수 있지만 이 플래그는 예약되어 있으며 설정해도 아무런 효과가 없습니다.

반환 값

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

반환 코드	설명
JET_errSuccess	작업이 성공적으로 완료되었습니다.
JET_errClientRequestToStopJetService	JetStopService 호출로 인해 세션과 연결된 instance 모든 작업이 중단되었으므로 작업을 완료할 수 없습니다.
JET_errInvalidParameter	제공된 매개 변수 중 하나에 예기치 않은 값이 포함되어 있거나 여러 매개 변수 값의 조합으로 예기치 않은 결과가 발생했습니다.
JET_errInvalidSesid	세션이 유효한 JET 세션이 아니었습니다.
JET_errNotInitialized	세션과 연결된 instance 아직 초기화되지 않았기 때문에 작업을 완료할 수 없습니다.
JET_errOutOfMemory	메모리를 할당할 수 없어 작업이 실패했습니다.
JET_errSessionInUse	즉, 세션이 다른 스레드에서 사용 중이거나 세션이 제대로 설정되거나 다시 설정되지 않았습니다.
JET_errInstanceUnavailable	세션과 연결된 instance 해당 데이터의 무결성을 보호하기 위해 모든 데이터에 대한 액세스를 해지해야 하는 심각한 오류가 발생하여 작업을 완료할 수 없습니다. 이 오류는 Windows XP 이상 릴리스에서만 반환됩니다.
JET_errOutOfBuffers	버퍼가 더 이상 없음을 나타내는 시스템 오류입니다.
JET_errRestoreInProgress	세션과 연결된 instance 복원 작업이 진행 중이므로 작업을 완료할 수 없습니다.
JET_errTermInProgress	세션과 연결된 instance 종료 중이므로 작업을 완료할 수 없습니다.

성공하면 세션 핸들이 닫혀 사용할 수 없으며 이 세션과 관련된 모든 리소스가 정리됩니다.

실패 시 정렬 테이블 닫기, 커서 닫기 및 트랜잭션 롤백의 일부로 발생할 수 있는 몇 가지 추가 오류가 있습니다. 이러한 오류는 거의 불가능하며 JetEndSession 이 호출될 때 세션이 완전히 사용되지 않는 경우는 거의 없습니다. 세션의 일부를 제대로 정리할 수 없는 경우 이러한 오류가 반환됩니다.

설명

이 API는 열려 있는 트랜잭션을 롤백합니다(수준 0에 커밋되지 않음). 또한 이 세션과 연결된 모든 커서와 만들거나 연 정렬 테이블이 정리됩니다.

요구 사항

요구 사항	값
클라이언트	Windows Vista, Windows XP 또는 Windows 2000 Professional이 필요합니다.
서버	Windows Server 2008, Windows Server 2003 또는 Windows 2000 Server가 필요합니다.
머리글	Esent.h에 선언되었습니다.
라이브러리	ESENT.lib를 사용합니다.
DLL	ESENT.dll 필요합니다.

참고 항목

JET_GRBIT
JET_SESID
JetBeginSession
JetRollback
JetSetSystemParameter
JetStopService

JetEndSession 함수