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
시스템 매개 변수