Fungsi JetGetThreadStats

Berlaku untuk: Windows | Windows Server

Fungsi JetGetThreadStats

Fungsi JetGetThreadStats mengambil informasi performa dari mesin database untuk utas saat ini. Beberapa panggilan dapat digunakan untuk mengumpulkan statistik yang mencerminkan aktivitas mesin database pada utas ini di antara panggilan tersebut.

Windows Vista:JetGetThreadStats diperkenalkan di Windows Vista.

    JET_ERR JET_API JetGetThreadStats(
      __out         void* pvResult,
      __in          unsigned long cbMax
    );

Parameter

pvResult

Buffer output yang menerima data statistik utas. Buffer berisi struktur JET_THREADSTATS setelah panggilan berhasil.

cbMax

Ukuran maksimum dalam byte dari buffer output.

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_errBufferTooSmall	Operasi gagal karena buffer output yang disediakan terlalu kecil untuk berisi data yang diminta. Fungsi JetGetThreadStats akan mengembalikan kesalahan ini ketika buffer output terlalu kecil untuk berisi versi terkecil dari struktur JET_THREADSTATS yang didukung oleh mesin database.

Setelah berhasil, buffer output akan berisi struktur JET_THREADSTATS yang berisi statistik mesin database untuk utas saat ini.

Jika gagal, status buffer output tidak terdefinisi.

Keterangan

Informasi yang diberikan oleh dua panggilan berturut-turut dari API ini dimaksudkan untuk digunakan untuk menghitung pengeluaran operasi mesin database lainnya pada utas saat ini. Umumnya, ini dilakukan dengan mengambil sebelum dan sesudah membaca statistik dan mengurangi jumlah setelah dari jumlah sebelumnya untuk mendapatkan jumlah bersih operasi yang dilakukan.

Misalnya, aplikasi dapat memanggil JetGetThreadStats sekali untuk mendapatkan pembacaan awal statistik untuk utas saat ini. Kemudian dapat memanggil fungsi JetMove dengan parameter cRow diatur ke JET_MoveNext untuk pindah ke entri indeks berikutnya pada indeks. Kemudian dapat memanggil JetGetThreadStats lagi untuk mendapatkan pembacaan lain dari statistik utas. Kemudian dapat mengurangi penghitung cPageReferenced dari pembacaan kedua dari yang pertama. Hasilnya adalah jumlah halaman database yang dirujuk oleh mesin database untuk melakukan operasi JetMove .

Statistik untuk setiap utas diakumulasikan selama masa pakai utas tersebut. Statistik diatur ulang jika DLL mesin database dibongkar dari proses host.

Struktur JET_THREADSTATS kemungkinan akan diperluas di masa depan untuk berisi lebih banyak statistik. Statistik baru akan ditambahkan ke akhir struktur dan dapat diambil dengan peningkatan ukuran buffer output. Kehadiran statistik tambahan dapat disimpulkan oleh nilai cbStruct yang lebih besar.

Persyaratan

Persyaratan	Nilai
Klien	Membutuhkan Windows Vista.
Server	Membutuhkan Windows Server 2008.
Header	Dinyatakan dalam Esent.h.
Pustaka	Gunakan ESENT.lib.
DLL	Membutuhkan ESENT.dll.

Lihat juga

JET_ERR
JET_THREADSTATS
JetMove