Fungsi JetGetTableInfo

Artikel
06/13/2023

Berlaku untuk: Windows | Windows Server

Fungsi JetGetTableInfo

Fungsi JetGetTableInfo mengambil berbagai informasi tentang tabel dalam database.

    JET_ERR JET_API JetGetTableInfo(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __out         void* pvResult,
      __in          unsigned long cbMax,
      __in          unsigned long InfoLevel
    );

Parameter

sesid

Konteks sesi database yang akan digunakan untuk panggilan API.

tableid

Tabel tempat informasi berlaku.

pvResult

Penunjuk ke buffer yang akan menerima informasi. Jenis buffer bergantung pada InfoLevel. Penelepon bertanggung jawab untuk menyelaraskan buffer dengan tepat.

cbMax

Ukuran, dalam byte, dari buffer yang diteruskan di pvResult.

InfoLevel

Jenis informasi yang akan diambil untuk tabel yang ditentukan oleh tableid. Format data yang disimpan di pvResult bergantung pada InfoLevel.

Opsi berikut dapat diatur untuk parameter ini:

Nilai	Makna
JET_TblInfo	pvResult ditafsirkan sebagai struktur JET_OBJECTINFO . Jika metode berhasil, struktur JET_OBJECTINFO diisi dengan data yang sesuai. Jika gagal, konten tidak terdefinisi.
JET_TblInfoDbid	pvResult diperlakukan sebagai array dari dua objek JET_DBID . Pengidentifikasi database database yang memiliki tabel disimpan dalam array ini dua kali.
JET_TblInfoDumpTable	JET_TblInfoDumpTable tidak digunakan lagi. API akan mengembalikan JET_errFeatureNotAvailable.
JET_TblInfoName	JET_TblInfoName mengambil nama tabel dan menyimpannya di pvResult. Jika buffer terlalu kecil, perilakunya tidak terdefinisi.
JET_TblInfoMostMany	JET_TblInfoMostMany mengambil nama tabel dan menyimpannya di pvResult. Jika buffer terlalu kecil, perilakunya tidak terdefinisi.
JET_TblInfoOLC	JET_TblInfoOLC tidak digunakan lagi. API akan mengembalikan JET_errFeatureNotAvailable.
JET_TblInfoRvt	JET_TblInfoRvt tidak digunakan lagi. API akan mengembalikan JET_errQueryNotSupported.
JET_TblInfoResetOLC	JET_TblInfoResetOLC tidak digunakan lagi. API akan mengembalikan JET_errFeatureNotAvailable.
JET_TblInfoSpaceAlloc	pvResult ditafsirkan sebagai array dari dua ULONG: ULONG pertama adalah jumlah halaman dalam tabel. ULONG kedua adalah kepadatan target halaman untuk tabel.
JET_TblInfoSpaceAvailable	pvResult ditafsirkan sebagai ULONG. ULONG adalah jumlah halaman yang tersedia dalam tabel, indeksnya, dan pohon nilai panjang.
JET_TblInfoSpaceOwned	pvResult ditafsirkan sebagai ULONG. ULONG adalah jumlah halaman yang dimiliki oleh tabel (termasuk indeksnya, dan pohon nilai panjang dan halaman yang tersedia di dalamnya).
JET_TblInfoSpaceUsage	Perilaku API tergantung pada seberapa besar buffer yang diteruskan ke API. Dua nilai cbMax harus setidaknya ( 2 * sizeof( ULONG ) ). Jika cbMax adalah ( 2 * sizeof( ULONG ) ), pvResult ditafsirkan sebagai array dari dua ULONG: ULONG pertama adalah jumlah Ekstensi tabel yang Dimiliki. ULONG kedua adalah jumlah Jangkauan tabel yang Tersedia. pvResult ditafsirkan sebagai array dari: ULONG pertama adalah jumlah Ekstensi tabel yang Dimiliki. ULONG kedua adalah jumlah Jangkauan tabel yang Tersedia.
JET_TblInfoTemplateTableName	pvResult ditafsirkan sebagai buffer string. Buffer harus setidaknya JET_cbNameMost + 1, termasuk NULL yang mengakhiri. Jika tabel adalah tabel turunan, buffer akan diisi dengan nama tabel tempat tabel turunan mewarisi DDL-nya. Jika tabel bukan tabel turunan, buffer akan menjadi string kosong.

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_errBufferTooSmall	Buffer terlalu kecil.
JET_errFeatureNotAvailable	InfoLevel yang tidak digunakan lagi ditentukan.
JET_errInvalidBufferSize	Buffer tidak berukuran tepat.
JET_errInvalidOperation	Tabel yang diteruskan adalah tabel sementara, dan InfoLevel yang diminta tidak dapat diambil untuk tabel sementara.
JET_errObjectNotFound	Tabel yang diteruskan adalah tabel sementara, dan InfoLevel yang diminta tidak dapat diambil untuk tabel sementara.
JET_errQueryNotSupported	InfoLevel tidak didukung.
JET_errTableInUse	Tabel sedang digunakan oleh operasi database lain.
JET_errTableLocked	Tabel dikunci oleh operasi database lain.
JET_wrnTableInUseBySystem	Tabel sedang digunakan oleh sistem. Peringatan ini tidak penting.

Keterangan

Beberapa informasi tidak valid untuk tabel sementara (Lihat JetOpenTempTable).

Statistik tabel mencakup jumlah rekaman dan jumlah halaman dalam indeks berkluster (yaitu, indeks yang berisi data rekaman). Statistik indeks diakses secara terpisah berdasarkan nama, menggunakan JetGetIndexInfo atau JetGetTableIndexInfo.

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 JetGetTableInfoW (Unicode) dan JetGetTableInfoA (ANSI).

Lihat juga

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JetGetIndexInfo
JetGetObjectInfo
JetGetTableIndexInfo
JetOpenTempTable

Fungsi JetGetTableInfo