Bagikan melalui

Fungsi JetBeginTransaction3

  • Artikel

Berlaku untuk: Windows | Windows Server

Fungsi JetBeginTransaction3 menyebabkan sesi memasuki transaksi dan membuat titik penyimpanan baru. Fungsi ini dapat dipanggil lebih dari sekali dalam satu sesi untuk membuat titik penyimpanan tambahan. Titik penyimpanan ini dapat digunakan untuk secara selektif untuk menyimpan atau membuang perubahan pada database.

Fungsi JetBeginTransaction3 diperkenalkan dalam sistem operasi Windows 8.

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

Parameter

di-sesi

Sesi yang digunakan untuk panggilan ini.

trxid

Pengidentifikasi opsional yang disediakan oleh pengguna untuk mengidentifikasi transaksi.

grbit

Sekelompok bit yang menentukan nol atau lebih dari nilai opsi panggilan yang tercantum dalam tabel berikut ini.

Nilai

Makna

JET_bitTransactionReadOnly

Transaksi tidak akan mengubah database. Jika pembaruan dicoba, operasi tersebut akan gagal dengan kode respons JET_errTransReadOnly. Opsi ini diabaikan kecuali diminta ketika sesi yang diberikan belum dalam transaksi. Opsi ini tersedia dalam versi sistem operasi Windows yang dimulai dengan Windows XP.

Nilai hasil

Fungsi ini mengembalikan jenis data JET_ERR dengan salah satu kode pengembalian yang tercantum dalam tabel berikut. Untuk informasi selengkapnya tentang kemungkinan kesalahan Extensible Storage Engine (ESE), lihat Kesalahan Mesin Penyimpanan yang Dapat Diperluas dan Parameter Penanganan Kesalahan.

Mengembalikan kode

Deskripsi

JET_errSuccess

Operasi berhasil diselesaikan.

JET_errClientRequestToStopJetService

Tidak dimungkinkan untuk menyelesaikan operasi karena semua aktivitas pada instans yang terkait dengan sesi telah berhenti sebagai akibat dari panggilan ke fungsi JetStopService .

JET_errInstanceUnavailable

Tidak dimungkinkan untuk menyelesaikan operasi karena instans yang terkait dengan sesi telah mengalami kesalahan fatal yang mengharuskan akses ke semua data dicabut untuk melindungi integritas data tersebut.

Kode pengembalian ini dikembalikan oleh versi Windows yang dimulai dengan Windows XP.

JET_errNotInitialized

Tidak dimungkinkan untuk menyelesaikan operasi karena instans yang terkait dengan sesi belum diinisialisasi.

JET_errRestoreInProgress

Tidak dimungkinkan untuk menyelesaikan operasi karena operasi pemulihan sedang berlangsung pada instans yang terkait dengan sesi.

JET_errSessionSharingViolation

Sesi yang sama tidak dapat digunakan untuk lebih dari satu utas secara bersamaan. Kesalahan ini dikembalikan oleh versi Windows yang dimulai dengan Windows XP.

JET_errTermInProgress

Tidak dimungkinkan untuk menyelesaikan operasi karena instans yang terkait dengan sesi sedang dimatikan.

JET_errTransTooDeep

Transaksi baru tidak dapat dimulai karena sesi sudah pada kedalaman titik penyimpanan maksimum yang diizinkan oleh mesin database.

Jika berhasil, sesi yang disediakan akan berada di dalam transaksi. Jika sesi sebelumnya berada di dalam transaksi, titik penyimpanan baru akan dibuat.

Jika gagal, status transaksional sesi tidak akan berubah. Tidak ada perubahan pada status database yang akan terjadi.

Keterangan

Untuk informasi selengkapnya tentang cara kerja transaksi, lihat JetBeginTransaction.

Persyaratan

Persyaratan Nilai

Klien

Memerlukan Windows 8.

Server

Memerlukan Windows Server 2012.

Header

Dinyatakan dalam Esent.h.

Pustaka

Gunakan ESENT.lib.

DLL

Memerlukan ESENT.dll.

Baca juga

JET_ERR
JET_GRBIT
JET_SESID
JetBeginTransaction
JetCommitTransaction
JetGetSystemParameter
JetResetSessionContext
JetRollback
JetSetSessionContext
Parameter Sistem