Kesalahan Mesin Penyimpanan yang Dapat Diperluas

Berlaku untuk: Windows | Windows Server

Kesalahan Mesin Penyimpanan yang Dapat Diperluas

Semua kemungkinan kesalahan yang dikembalikan oleh API Extensible Storage Engine (ESE) ditentukan oleh jenis data JET_ERR. Untuk daftar bendera kesalahan yang ditentukan untuk API ini, lihat Kode Kesalahan Mesin Penyimpanan yang Dapat Diperluas.

Sepanjang dokumentasi ESE API, hanya kesalahan terpenting yang didokumenkan. Kesalahan ini biasanya mewakili kesalahan penggunaan API atau kondisi kesalahan yang sangat penting. Ketahuilah bahwa salah satu API ESE ini juga dapat mengembalikan kesalahan lain yang tidak didokumentasikan untuk setiap API. Dalam kasus ini, pemanggil hanya boleh menangani kesalahan seperti kesalahan lain yang dikembalikan oleh API. Nilai kesalahan tertentu kemudian dapat digunakan untuk tujuan diagnostik seperti pelacakan.

Secara umum, nilai yang lebih besar dari nol harus ditafsirkan sebagai peringatan, nilai nol harus ditafsirkan sebagai keberhasilan, dan nilai yang kurang dari nol harus ditafsirkan sebagai kesalahan. Tidak ada pola lain dalam nilai-nilai ini (misalnya, rentang nilai) yang harus diandalkan oleh aplikasi.

Ketika ESE mengalami beberapa kesalahan yang lebih serius, ESE membuat entri log peristiwa yang berisi detail tentang kesalahan. Tingkat pengelogan dapat dikontrol oleh Parameter Log Peristiwa .

Beberapa aplikasi memerlukan kemampuan untuk mengembalikan JET_ERRsebagai HRESULTs. Contoh C++ berikut menunjukkan cara melakukan konversi tersebut:

    #ifndef FACILITY_JET_ERR
    #define FACILITY_JET_ERR 0xE5E
    #endif
    #ifndef HRESULT_FROM_JET_ERR
    #define HRESULT_FROM_JET_ERR( __err )
    (
      ( __err ) == JET_errSuccess ?
      S_OK :
      (
        ( __err ) == JET_errOutOfMemory ?
        E_OUTOFMEMORY :
        MAKE_HRESULT
        (
          (
            ( __err ) < 0 ?
            SEVERITY_ERROR :
            SEVERITY_SUCCESS
          ),
          FACILITY_JET_ERR,
          (
            ( __err ) < 0 ?
            -( __err ) :
            ( __err )
          )
          & 0xFFFF
        )
      )
    )
    
    #endif

Untuk informasi tentang mengonfigurasi parameter sistem untuk penanganan kesalahan, lihat Parameter Penanganan Kesalahan .

Lihat Juga

Parameter Penanganan Kesalahan

Kode Kesalahan Mesin Penyimpanan yang Dapat Diperluas

JET_ERR