Bagikan melalui

Fungsi JetGetErrorInfoW

  • Artikel

Berlaku untuk: Windows | Windows Server

Fungsi JetGetErrorInfoW

Fungsi JetGetErrorInfoW BAS_ mesin database.

Catatan: Dokumentasi ini didasarkan pada rilis awal Dari Extensible Storage Engine. Informasi ini dapat berubah.

JET_ERR JET_API JetGetErrorInfoW( 
    _In_opt_ void *                      pvContext, 
    _Out_writes_bytes_( cbMax ) void *   pvResult, 
    _In_ unsigned long                   cbMax, 
    _In_ unsigned long                   InfoLevel, 
    _In_ JET_GRBIT                       grbit );

Parameter

pvContext

Konteks atau nilai kesalahan yang diperlukan informasi kesalahan yang diperluas. Nilai yang diteruskan bergantung pada nilai parameter InfoLevel .

pvResult

Penunjuk ke buffer yang akan menerima informasi. Jenis buffer bergantung pada nilai parameter InfoLevel . Pemanggil harus dikonfigurasi untuk meratakan buffer dengan tepat.

cbMax

Ukuran maksimum struktur pvResult yang diteruskan.

InfoLevel

Jenis informasi yang akan diambil untuk info/konteks kesalahan ditentukan oleh parameter pvContext . Format data yang disimpan di pvResult bergantung pada InfoLevel.

Tabel berikut mencantumkan nilai yang mungkin untuk parameter ini.

Nilai

Makna

JET_ErrorInfoSpecificErr

pvContext ditafsirkan sebagai kode JET_ERR/kesalahan, pvResult ditafsirkan sebagai JET_ERRINFOBASIC_W, dan bidang struktur JET_ERRINFOBASIC_W diisi dengan tepat.

grbit

Dicadangkan.

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

Deskripsi

JET_errSuccess

Operasi berhasil diselesaikan.

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 JetGetErrorInfo ketika hal berikut terjadi:

  • Nilai parameter InfoLevel yang ditentukan tidak valid.

  • Nilai grbit yang ditentukan tidak valid.

  • Nilai cbMax buffer parameter pvResult yang ditentukan kurang dari ukuran yang diperlukan untuk output parameter InfoLevel ini.

  • Untuk InfoLevel = JET_ErrorInfoSpecificErr, nilai JET_ERR yang diteruskan tidak diketahui oleh mesin.

JET_errDisabledFunctionality

Jika SKU jendela ini tidak mendukung fungsi ini, kesalahan ini akan dikembalikan.

Jika berhasil, buffer output yang sesuai untuk konteks/nilai kesalahan yang diminta akan diatur ke info kesalahan yang diperluas yang diminta.

Jika gagal, status buffer output tidak akan terdefinisi.

Keterangan

Fungsi JET_ERRINFOBASIC_W dan grup konstanta JET_ERRCAT berisi dokumentasi tentang informasi kesalahan yang diperluas yang dikembalikan untuk InfoLevel = JET_ErrorInfoSpecificErr.

Persyaratan

Persyaratan Nilai

Klien

Membutuhkan Windows 8.

Server

Membutuhkan Server Windows 8.

Header

Dinyatakan dalam Esent.h.

Pustaka

Gunakan ESENT.lib.

DLL

Membutuhkan ESENT.dll.

Unicode

Catatan: Hanya JetGetErrorInfoW (Unicode) yang diimplementasikan. API ini tidak memiliki versi A (ANSI).