Struktur JET_TABLECREATE

Artikel
06/13/2023

Berlaku untuk: Windows | Windows Server

Struktur JET_TABLECREATE

Struktur JET_TABLECREATE berisi informasi yang diperlukan untuk membuat tabel yang diisi dengan kolom dan indeks dalam database ESE. Struktur JET_TABLECREATE digunakan oleh JetCreateTableColumnIndex

    typedef struct tagJET_TABLECREATE {
      unsigned long cbStruct;
      tchar* szTableName;
      tchar* szTemplateTableName;
      unsigned long ulPages;
      unsigned long ulDensity;
      JET_COLUMNCREATE* rgcolumncreate;
      unsigned long cColumns;
      JET_INDEXCREATE* rgindexcreate;
      unsigned long cIndexes;
      JET_GRBIT grbit;
      JET_TABLEID tableid;
      unsigned long cCreated;
    } JET_TABLECREATE;

Anggota

cbStruct

Ukuran struktur ini dalam byte (untuk ekspansi di masa mendatang). Ini harus diatur ke sizeof( JET_TABLECREATE ) dalam byte.

szTableName

Nama tabel yang akan dibuat.

Nama harus menggunakan memenuhi ketentuan berikut:

Memiliki nilai kurang dari JET_cbNameMost, tidak termasuk NULL yang mengakhiri.

Terdiri dari sekumpulan karakter berikut: 0 hingga 9, A hingga Z, a hingga z, dan semua tanda baca lainnya kecuali untuk tanda seru (!), koma (,), kurung buka ([), dan kurung siku penutup (]), yaitu, karakter ASCII 0x20, 0x22 melalui 0x2d, 0x2f melalui 0x5a, 0x5c, dan 0x5d melalui 0x7f.

Tidak dimulai dengan spasi.

Terdiri dari setidaknya satu karakter non-spasi.

szTemplateTableName

Nama tabel yang sudah ada untuk mewarisi DDL dasar (Bahasa Definisi Data). Penggunaan tabel templat memungkinkan pembuatan banyak tabel yang mudah dengan kolom dan indeks yang identik.

ulPages

Jumlah awal halaman database yang akan dialokasikan untuk tabel. Menentukan angka yang lebih besar dari satu dapat mengurangi fragmentasi jika banyak baris disisipkan ke dalam tabel ini.

ulDensity

Kepadatan tabel, dalam persentase titik. Angka harus 0 atau dalam kisaran 20 hingga 100. Meneruskan 0 berarti bahwa nilai default harus digunakan. Defaultnya adalah 80.

rgcolumncreate

Array struktur JET_COLUMNCREATE , yang masing-masing sesuai dengan kolom yang akan dibuat dalam tabel baru.

cColumns

Jumlah elemen JET_COLUMNCREATE dalam rgcolumncreate.

rgindexcreate

Array struktur JET_INDEXCREATE , yang masing-masing sesuai dengan indeks yang akan dibuat dalam tabel baru.

cIndexes

Jumlah elemen JET_INDEXCREATE dalam rgindexcreate.

grbit

Sekelompok bit yang berisi opsi untuk panggilan ini, yang menyertakan nol atau beberapa nilai berikut.

Nilai	Makna
JET_bitTableCreateFixedDDL	Pengaturan JET_bitTableCreateFixedDDL mencegah operasi DDL pada tabel (seperti menambahkan atau menghapus kolom).
JET_bitTableCreateTemplateTable	Pengaturan JET_bitTableCreateTemplateTable menyebabkan tabel menjadi tabel templat. Tabel baru kemudian dapat menentukan nama tabel ini sebagai tabel templatnya. Pengaturan JET_bitTableCreateTemplateTable menyiratkan JET_bitTableCreateFixedDDL.
JET_bitTableCreateNoFixedVarColumnsInDerivedTables	Dihentikan. Jangan gunakan.

tableid

Bidang output yang menyimpan JET_TABLEID tabel baru jika panggilan API berhasil. Jika panggilan API gagal, nilainya tidak terdefinisi.

cCreated

Bidang output yang berisi jumlah objek yang dibuat jika panggilan API berhasil. Jika panggilan API gagal, nilainya tidak terdefinisi.

Jumlah objek yang dibuat sama dengan jumlah kolom, tabel, dan indeks yang berhasil dibuat.

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.
Unicode	Diimplementasikan sebagai JET_TABLECREATE_W (Unicode) dan JET_TABLECREATE_A (ANSI).

Lihat juga

JET_CALLBACK
JET_CBTYP
JET_CONDITIONALCOLUMN
JET_ERR
JET_GRBIT
JET_TABLEID
JET_INDEXCREATE
JetCreateTable
JetCreateTableColumnIndex
JetCreateTableColumnIndex2

Struktur JET_TABLECREATE