다음을 통해 공유


JetBeginTransaction3 함수

적용 대상: Windows | Windows Server

JetBeginTransaction3 함수는 세션이 트랜잭션을 입력하고 새 저장 지점을 만듭니다. 이 함수는 단일 세션에서 두 번 이상 호출하여 추가 저장 지점을 만들 수 있습니다. 이러한 저장 지점은 데이터베이스 변경 내용을 선택적으로 유지하거나 해제하는 데 사용할 수 카드.

JetBeginTransaction3 함수는 Windows 8 운영 체제에서 도입되었습니다.

JET_ERR JET_API JetBeginTransaction3(
  __in          JET_SESID sesid,
  __in          int64 trxid,
  __in          JET_GRBIT grbit
);

매개 변수

sesid

이 호출에 사용할 세션입니다.

trxid

트랜잭션을 식별하기 위해 사용자가 제공하는 선택적 식별자입니다.

grbit

다음 표에 나열된 0개 이상의 호출 옵션 값을 지정하는 비트 그룹입니다.

의미

JET_bitTransactionReadOnly

트랜잭션은 데이터베이스를 수정하지 않습니다. 업데이트를 시도하면 JET_errTransReadOnly 응답 코드로 해당 작업이 실패합니다. 지정된 세션이 트랜잭션에 아직 없는 경우 요청되지 않는 한 이 옵션은 무시됩니다. 이 옵션은 Windows XP부터 Windows 운영 체제 버전에서 사용할 수 있습니다.

반환 값

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

반환 코드

설명

JET_errSuccess

작업이 성공적으로 완료되었습니다.

JET_errClientRequestToStopJetService

JetStopService 함수 호출로 인해 세션과 연결된 인스턴스의 모든 작업이 중단되었으므로 작업을 완료할 수 없습니다.

JET_errInstanceUnavailable

세션과 연결된 인스턴스에서 해당 데이터의 무결성을 보호하기 위해 모든 데이터에 대한 액세스를 해지해야 하는 심각한 오류가 발생하여 작업을 완료할 수 없습니다.

이 반환 코드는 Windows XP부터 Windows 버전에서 반환됩니다.

JET_errNotInitialized

세션과 연결된 인스턴스가 아직 초기화되지 않았기 때문에 작업을 완료할 수 없습니다.

JET_errRestoreInProgress

세션과 연결된 인스턴스에서 복원 작업이 진행 중이므로 작업을 완료할 수 없습니다.

JET_errSessionSharingViolation

두 개 이상의 스레드에 대해 동시에 동일한 세션을 사용할 수 없습니다. 이 오류는 Windows XP부터 Windows 버전에서 반환됩니다.

JET_errTermInProgress

세션과 연결된 인스턴스가 종료되고 있으므로 작업을 완료할 수 없습니다.

JET_errTransTooDeep

세션이 데이터베이스 엔진에서 허용하는 최대 저장 지점 깊이에 이미 있으므로 새 트랜잭션을 시작할 수 없습니다.

성공하면 제공된 세션이 트랜잭션 내에 있습니다. 세션이 이전에 트랜잭션 내에 있는 경우 새 저장 지점이 만들어집니다.

실패하면 세션의 트랜잭션 상태가 변경되지 기본. 데이터베이스 상태가 변경되지 않습니다.

설명

트랜잭션 작동 방식에 대한 자세한 내용은 JetBeginTransaction을 참조하세요.

요구 사항

요구 사항

클라이언트

Windows 8이 필요합니다.

서버

Windows Server 2012가 필요합니다.

Header

Esent.h에서 선언되었습니다.

라이브러리

ESENT.lib를 사용합니다.

Dll

ESENT.dll이 필요합니다.

참고 항목

JET_ERR
JET_GRBIT
JET_SESID
JetBeginTransaction
JetCommitTransaction
JetGetSystemParameter
JetResetSessionContext
JetRollback
JetSetSessionContext
시스템 매개 변수