Fungsi JetRenameTable

Berlaku untuk: Windows | Windows Server

Fungsi JetRenameTable

Fungsi JetRenameTable dapat digunakan untuk mengubah nama tabel yang sudah ada.

    JET_ERR JET_API JetRenameTable(
      __in          JET_SESID sesid,
      __in          JET_DBID dbid,
      __in          const tchar* szName,
      __in          const tchar* szNameNew
    );

Parameter

sesid

Sesi yang digunakan untuk panggilan ini.

dbid

Database yang digunakan untuk panggilan ini.

szName

Nama tabel saat ini yang akan diganti namanya.

szNameNew

Nama baru untuk tabel yang akan diganti namanya.

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_errClientRequestToStopJetService

Tidak mungkin untuk menyelesaikan operasi karena semua aktivitas pada instans yang terkait dengan sesi telah berhenti sebagai akibat dari panggilan ke 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. Kesalahan ini hanya akan dikembalikan oleh Windows XP dan rilis yang lebih baru.

JET_errInvalidDatabase

Database yang ditentukan tidak valid.

Kesalahan ini hanya dikembalikan di Windows 2000 ketika operasi penggantian nama tabel dicoba pada database sementara. JET_errInvalidDatabaseId dikembalikan untuk kasus ini dalam rilis selanjutnya.

JET_errInvalidDatabaseId

ID database yang ditentukan tidak valid.

JET_errInvalidName

Salah satu nama objek yang ditentukan tidak valid. Semua nama objek harus sesuai dengan sekumpulan aturan yang sama. Aturan ini adalah sebagai berikut:

  • Nama objek harus terdiri dari karakter ASCII.

  • Panjang nama objek harus minimal satu karakter.

  • Panjang nama objek tidak boleh melebihi JET_cbNameMost (64).

  • Nama objek mungkin tidak dimulai dengan spasi.

  • Nama objek mungkin tidak berisi karakter kontrol ASCII (0x00 melalui 0x1F).

  • Nama objek tidak boleh berisi karakter tanda seru (!), titik (.), kurung siku kiri ([), atau kurung siku kanan (]) - setelah divalidasi, hanya bagian string hingga spasi pertama (jika ada) yang akan digunakan untuk nama objek. Ini secara efektif berarti bahwa nama objek mungkin juga tidak berisi spasi.

JET_errInvalidParameter

Salah satu parameter yang disediakan berisi nilai yang tidak terduga atau berisi nilai yang tidak masuk akal ketika dikombinasikan dengan nilai parameter lain. Ini dapat terjadi untuk JetRenameTable ketika:

  • szName adalah NULL.

  • szNameNew adalah NULL.

JET_errNotInitialized

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

JET_errObjectNotFound

Tabel yang ditentukan ini tidak ada untuk database ini.

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 hanya akan dikembalikan oleh Windows XP dan rilis yang lebih baru.

JET_errTermInProgress

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

JET_errTransReadOnly

Pembaruan tidak dapat dilakukan saat berada di dalam cakupan transaksi baca-saja. Transaksi baca-saja adalah transaksi yang telah dimulai menggunakan panggilan ke JetBeginTransaction2 dengan JET_bitTransactionReadOnly.

Kesalahan ini hanya akan dikembalikan oleh Windows XP dan rilis yang lebih baru.

Jika berhasil, nama tabel yang ditentukan dalam database yang diberikan diubah secara permanen ke nama baru.

Jika gagal, tidak ada perubahan pada status database yang akan terjadi.

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 JetRenameTableW (Unicode) dan JetRenameTableA (ANSI).

Lihat juga

JET_DBID
JET_ERR
JET_SESID
JetBeginTransaction2

  • Last updated on