Fungsi JetCreateIndex

Berlaku untuk: Windows | Windows Server

Fungsi JetCreateIndex

Fungsi JetCreateIndex memungkinkan Anda membuat indeks data dalam database Extensible Storage Engine (ESE), yang dapat Anda gunakan untuk menemukan data tertentu dengan cepat.

    JET_ERR JET_API JetCreateIndex(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          JET_PCSTR szIndexName,
      __in          JET_GRBIT grbit,
      __in          const tchar* szKey,
      __in          unsigned long cbKey,
      __in          unsigned long lDensity
    );

Parameter

sesid

Konteks sesi database yang digunakan untuk panggilan API tertentu.

tableid

Tabel tempat indeks akan dibuat.

szIndexName

Penunjuk ke string yang dihentikan null yang menentukan nama indeks yang akan dibuat.

Nama indeks harus sesuai dengan panduan berikut:

• Ini harus berisi lebih sedikit karakter daripada JET_cbNameMost, tidak termasuk karakter null yang mengakhiri.

• Ini harus berisi hanya karakter dari kategori berikut: 0 hingga 9, A hingga Z, a sampai z, dan semua karakter tanda baca kecuali untuk "!" (tanda seru), "," (koma), "[" (kurung buka), dan "]" (tanda kurung tutup) — yaitu, karakter ASCII 0x20, 0x22 melalui 0x2d, 0x2f melalui 0x5a, 0x5c, dan 0x5d melalui 0x7f.

• Ini tidak boleh dimulai dengan spasi.

• Ini harus berisi setidaknya satu karakter non-spasi.

grbit

Sekelompok bit yang berisi opsi yang akan digunakan untuk panggilan tertentu. Parameter ini dapat mencakup nol atau beberapa opsi yang ditemukan dalam struktur JET_INDEXCREATE .

szKey

Penunjuk ke string ganda yang dihentikan null dari token yang dibatasi null.

Untuk informasi selengkapnya tentang parameter ini, lihat struktur JET_INDEXCREATE .

cbKey

Panjangnya, dalam byte, dari parameter szKey , termasuk dua karakter null yang mengakhiri.

LDensity

Persentase kepadatan pohon B+ indeks awal.

Untuk informasi selengkapnya tentang parameter ini, lihat struktur JET_INDEXCREATE .

Tampilkan Nilai

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

Menampilkan kode	Makna
JET_errSuccess	Operasi berhasil diselesaikan.

Untuk daftar kesalahan tambahan yang dapat dikembalikan oleh fungsi JetCreateIndex , lihat JetCreateIndex2.

Keterangan

Memanggil fungsi JetCreateIndex identik dengan memanggil fungsi JetCreateIndex2 dengan struktur JET_INDEXCREATE yang berisi pengaturan yang sama dengan parameter JetCreateIndex, dan parameter cIndexCreate sama dengan 1. Untuk bidang struktur JET_INDEXCREATE yang tidak memiliki parameter yang sesuai di JetCreateIndex, nilai 0 diasumsikan.

Perhatikan bahwa JetCreateIndex telah digantikan oleh JetCreateIndex2.

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	Menggunakan ESENT.lib.
DLL	Membutuhkan ESENT.dll.
Unicode	Diimplementasikan sebagai JetCreateIndexW (Unicode) dan JetCreateIndexA (ANSI).

Lihat juga

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_INDEXCREATE
JetCreateIndex2
JetCreateTableColumnIndex
JetCreateTableColumnIndex2