Bagikan melalui

Fungsi JetGetInstanceInfo

  • Artikel

Berlaku untuk: Windows | Windows Server

Fungsi JetGetInstanceInfo

Fungsi JetGetInstanceInfo mengambil informasi tentang instans yang sedang berjalan.

Windows XP: JetGetInstanceInfo diperkenalkan di Windows XP.

    JET_ERR JET_API JetGetInstanceInfo(
      __out         unsigned long* pcInstanceInfo,
      __out         JET_INSTANCE_INFO** paInstanceInfo
    );

Parameter

pcInstanceInfo

Pointer ke buffer yang akan menerima jumlah elemen yang disimpan di paInstanceInfo.

paInstanceInfo

Penunjuk ke buffer yang akan menerima alamat elemen pertama dari array struktur.

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_errInvalidParameter

Salah satu parameter yang disediakan berisi nilai yang tidak terduga atau berisi nilai yang tidak masuk akal ketika dikombinasikan dengan nilai parameter lain. Kesalahan ini akan dikembalikan oleh JetGetInstanceInfo ketika:

  • pcInstanceInfo atau paInstanceInfo adalah NULL.

JET_errOutOfMemory

Memori tidak cukup untuk memproses permintaan.

Keterangan

Mesin database akan mengalokasikan array struktur JET_INSTANCE_INFO . Pemanggil bertanggung jawab untuk membebaskan memori ini dengan JetFreeBuffer.

Jika tidak ada instans aktif, JetGetInstanceInfo akan mengembalikan JET_errSuccess, dan pcInstanceInfo akan menerima nilai 0.

Persyaratan

Persyaratan Nilai

Klien

Memerlukan Windows Vista atau Windows XP.

Server

Memerlukan Windows Server 2008 atau Windows Server 2003.

Header

Dinyatakan dalam Esent.h.

Pustaka

Gunakan ESENT.lib.

DLL

Membutuhkan ESENT.dll.

Unicode

Diimplementasikan sebagai JetGetInstanceInfoW (Unicode) dan JetGetInstanceInfoA (ANSI).

Lihat juga

JET_ERR
JET_INSTANCE
JET_INSTANCE_INFO
JetFreeBuffer