JetDupSession 함수

아티클
06/13/2023

적용 대상: Windows | Windows Server

JetDupSession 함수

JetDupSession 함수는 세션을 시작하고 ESE 세션 핸들(JET_SESID)을 초기화하고 반환합니다. 세션은 데이터베이스에 대한 모든 액세스를 제어하며 트랜잭션의 scope 제어하는 데 사용됩니다. 세션을 사용하여 트랜잭션을 시작, 커밋 또는 중단할 수 있습니다. 세션은 데이터베이스를 연결, 만들기 또는 여는 데도 사용됩니다. 세션은 모든 DDL 및 DML 작업의 컨텍스트로 사용됩니다. 데이터베이스에 대한 동시성 및 병렬 액세스를 늘리기 위해 여러 세션을 시작합니다.

참고 이 API는 전달된 세션의 instance 대해 호출된 JetBeginSession으로 모든 방식으로 작동합니다. 이 함수는 권장되지 않습니다. JetBeginSession 을 사용하는 것이 좋습니다.

    JET_ERR JET_API JetDupSession(
      __in          JET_SESID sesid,
      __out         JET_SESID* psesid
    );

매개 변수

sesid

세션을 복제하거나 시작하기 위한 원본으로 사용할 세션입니다.

psesid

성공적인 반환 시 세션 핸들이 초기화하는 변수에 대한 포인터입니다.

반환 값

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

반환 코드	설명
JET_errSuccess	작업이 성공적으로 완료되었습니다.
JET_errClientRequestToStopJetService	JetStopService 호출로 인해 세션과 연결된 instance 모든 작업이 중단되었으므로 작업을 완료할 수 없습니다.
JET_errInstanceUnavailable	세션과 연결된 instance 해당 데이터의 무결성을 보호하기 위해 모든 데이터에 대한 액세스를 해지해야 하는 심각한 오류가 발생하여 작업을 완료할 수 없습니다. 이 오류는 Windows XP 이상 릴리스에서만 반환됩니다.
JET_errInvalidParameter	제공된 매개 변수 중 하나에 예기치 않은 값이 포함되어 있거나 다른 매개 변수의 값과 결합할 때 의미가 없는 값이 포함되어 있습니다.
JET_errNotInitialized	세션과 연결된 instance 아직 초기화되지 않았기 때문에 작업을 완료할 수 없습니다.
JET_errOutOfMemory	메모리를 할당할 수 없어 작업이 실패했습니다.
JET_errOutOfSessions	엔진에서 클라이언트를 시작할 수 있는 세션 수는 제한됩니다. 이 값은 JET_paramMaxSessions 상수와 함께 JetSetSystemParameter를 사용하여 변경할 수 있습니다. 기본 세션 수는 16개입니다. JET_paramMaxSessions 대한 자세한 내용은 시스템 매개 변수를 참조하세요.
JET_errRestoreInProgress	세션과 연결된 instance 복원 작업이 진행 중이므로 작업을 완료할 수 없습니다.
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 필요합니다.

참고 항목

JET_SESID
JetBeginSession
JetSetSystemParameter
JetStopService
시스템 매개 변수

다음을 통해 공유

JetDupSession 함수