Fungsi JetOpenTable

Artikel
06/13/2023

Berlaku untuk: Windows | Windows Server

Fungsi JetOpenTable

Fungsi JetOpenTable membuka kursor pada tabel yang dibuat sebelumnya.

    JET_ERR JET_API JetOpenTable(
      __in          JET_SESID sesid,
      __in          JET_DBID dbid,
      __in          const tchar* szTableName,
      __in_opt      const void* pvParameters,
      __in          unsigned long cbParameters,
      __in          JET_GRBIT grbit,
      __out         JET_TABLEID* ptableid
    );

Parameter

sesid

Konteks sesi database yang akan digunakan.

dbid

Pengidentifikasi database yang digunakan untuk menemukan tabel.

szTableName

Nama tabel yang akan dibuka.

pvParameters

Dihentikan. Atur ke NULL.

cbParameters

Dihentikan. Atur ke 0 (nol).

grbit

Sekelompok bit yang menentukan nol atau beberapa opsi berikut.

Nilai	Makna
JET_bitTableDenyRead	Tabel tidak dapat dibuka untuk akses baca oleh sesi database lain.
JET_bitTableDenyWrite	Tabel tidak dapat dibuka untuk akses tulis oleh sesi database lain.
JET_bitTableNoCache	Jangan singgahan halaman untuk tabel ini.
JET_bitTablePermitDDL	Memungkinkan modifikasi DDL pada tabel yang ditandai sebagai FixedDDL. Opsi ini harus digunakan dengan opsi JET_bitTableDenyRead.
JET_bitTablePreread	Memberikan petunjuk bahwa tabel mungkin tidak ada di cache buffer, dan pra-pembacaan tersebut mungkin bermanfaat bagi performa.
JET_bitTableReadOnly	Meminta akses baca-saja ke tabel.
JET_bitTableSequential	Tabel harus sangat agresif diambil sebelumnya dari disk karena aplikasi akan memindainya secara berurutan.
JET_bitTableUpdatable	Meminta akses tulis ke tabel.

ptableid

Jika berhasil, arahkan ke pengidentifikasi tabel. Jika gagal, konten untuk ptableid tidak terdefinisi.

Tampilkan Nilai

Fungsi ini mengembalikan jenis data JET_ERR dengan salah satu kode pengembalian berikut. Untuk informasi selengkapnya tentang kemungkinan kesalahan ESE, lihat Kesalahan Mesin Penyimpanan yang Dapat Diperluas dan Parameter Penanganan Kesalahan.

Menampilkan kode	Deskripsi
JET_errSuccess	Operasi berhasil diselesaikan.
JET_errInvalidDatabaseId	dbid bukan pengidentifikasi database yang valid.
JET_errInvalidgrbit	Kombinasi buruk dari grbit diteruskan.
JET_errInvalidName	Nama yang diberikan dalam szTableName tidak valid. Untuk informasi selengkapnya tentang nama tabel yang valid, lihat parameter szTableName di JetCreateTable.
JET_errObjectNotFound	Upaya dilakukan untuk membuka tabel yang tidak ada di database.
JET_errOutOfCursors	Operasi gagal karena mesin tidak dapat mengalokasikan sumber daya yang diperlukan untuk membuka kursor baru. Lihat bagian Keterangan.
JET_errTableInUse	Tabel sedang digunakan oleh operasi database lain.
JET_wrnTableInUseBySystem	Peringatan nonfatal yang menunjukkan bahwa tabel sedang digunakan oleh sistem.
JET_errTableLocked	Tabel dikunci oleh operasi database lain.
JET_errTooManyOpenTables	Upaya dilakukan untuk membuka terlalu banyak tabel unik sekaligus. Lihat bagian Keterangan.

Keterangan

Tabel yang dibuka dengan JetOpenTable biasanya harus ditutup dengan JetCloseTable. Pengecualian untuk aturan ini terjadi ketika JetOpenTable dipanggil dalam transaksi dan transaksi digulung balik (dengan JetRollback). Saat menggulung balik transaksi, tabel ditutup secara otomatis. Dalam hal ini, ini adalah kesalahan untuk menutup tabel dengan JetCloseTable.

Secara hukum untuk membuka tabel sistem dengan JetOpenTable (misalnya, MSysObjects, MSysUnicodeFixup). Skema tabel sistem dapat berubah, sehingga mengakses tabel sistem tidak disarankan. Jumlah tabel unik yang dapat dibuka secara bersamaan dipengaruhi langsung oleh JET_paramMaxOpenTables. Jika tabel saat ini terbuka maka kursor baru akan dibuat pada tabel. Sumber daya kursor dikonfigurasi menggunakan JetSetSystemParameter dengan JET_paramMaxCursors. Lihat juga JetDupCursor.

Persyaratan

Persyaratan	Nilai
Klien	Memerlukan Windows Vista, Windows XP, atau Windows 2000 Professional.
Server	Memerlukan Windows Server 2008, Windows Server 2003, atau Windows 2000 Server.
Header	Dinyatakan dalam Esent.h.
Pustaka	Gunakan ESENT.lib.
DLL	Membutuhkan ESENT.dll.
Unicode	Diimplementasikan sebagai JetOpenTableW (Unicode) dan JetOpenTableA (ANSI).

Lihat juga

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetCloseTable
JetDupCursor
JetRollback
JetSetSystemParameter
Parameter Sumber Daya

Fungsi JetOpenTable