Fungsi JetGetDatabaseFileInfo

Artikel
06/13/2023

Berlaku untuk: Windows | Windows Server

Fungsi JetGetDatabaseFileInfo

Fungsi JetGetDatabaseFileInfo mengambil berbagai jenis informasi tentang database. API ini dapat dipanggil saat database dilampirkan atau online (dengan JetGetDatabaseInfo) atau saat database atau mesin database offline (dengan JetGetDatabaseFileInfo).

    JET_ERR JET_API JetGetDatabaseFileInfo(
      __in          const tchar* szDatabaseName,
      __out         void* pvResult,
      __in          unsigned long cbMax,
      __in          unsigned long InfoLevel
    );

Parameter

szDatabaseName

Jalur database untuk mengambil informasi.

pvResult

Penunjuk ke buffer yang akan menerima informasi yang ditentukan. Ukuran buffer, dalam byte, diteruskan dalam cbMax.

Jika fungsi ini gagal, konten pvResult tidak terdefinisi.

Informasi yang disimpan di pvResult bergantung pada InfoLevel.

cbMax

Ukuran, dalam byte, dari buffer yang diteruskan di pvResult.

InfoLevel

InfoLevel menentukan jenis informasi mana yang harus diambil tentang database yang ditentukan. Ini mempengaruhi bagaimana pvResult ditafsirkan. Beberapa objek InfoLevel hanya tersedia dalam versi offline (JetGetDatabaseFileInfo) atau online (JetGetDatabaseInfo).

Jika buffer pvResult yang disediakan terlalu kecil, baik JET_errInvalidBufferSize atau JET_errBufferTooSmall akan dikembalikan, tergantung pada InfoLevel.

JET_DbInfoFilesize

pvResult akan ditafsirkan sebagai QWORD (8 byte). Mengembalikan ukuran database dalam byte.

JET_DbInfoUpgrade

pvResult akan ditafsirkan sebagai JET_DBINFOUPGRADE. Struktur JET_DBINFOUPGRADE akan diisi dengan informasi yang berkaitan dengan database yang ditentukan.

JET_DbInfoMisc

pvResult akan ditafsirkan sebagai JET_DBINFOMISC. Struktur JET_DBINFOMISC akan diisi dengan informasi yang berkaitan dengan database yang ditentukan.

JET_DbInfoDBInUse

pvResult akan ditafsirkan sebagai BOOL (4 byte). Ini akan mengembalikan apakah mesin database saat ini memiliki database yang terbuka atau terlampir.

Windows XP: Nilai ini diperkenalkan di Windows XP.

JET_DbInfoPageSize

pvResult akan ditafsirkan sebagai panjang yang tidak ditandatangani. Ini akan mengembalikan ukuran halaman database dalam byte.

Windows XP: Nilai ini diperkenalkan di Windows XP.

JET_DbInfoCp

InfoLevels ini belum didukung dan mengembalikan nilai default. Jangan gunakan InfoLevels ini.

JET_DbInfoCountry

InfoLevels ini belum didukung dan mengembalikan nilai default. Jangan gunakan InfoLevels ini.

JET_DbInfoCollate

Sama seperti JET_DbInfoCp.

JET_DbInfoIsam

InfoLevels ini tidak digunakan lagi dan saat ini tidak didukung. Jangan gunakan InfoLevels ini.

JET_DbInfoConnect

Sama seperti JET_DbInfoIsam.

JET_DbInfoFileType

Windows Vista: Nilai InfoLevel ini diperkenalkan di Windows Vista.

pvResult akan diperlakukan sebagai pointer ke DWORD. Mengembalikan nilai enumerasi, menunjukkan jenis file apa yang dianggap oleh mesin ini. Jenis file tercantum dalam tabel berikut ini. Untuk informasi selengkapnya tentang jenis file ini dan penggunaannya ke mesin, lihat File Mesin Penyimpanan yang Dapat Diperluas.

Nilai	Makna
JET_filetypeUnknown	Tipe file tidak diketahui, atau bukan tipe file ESE.
JET_filetypeDatabase	File adalah file database.
JET_filetypeLog	File adalah file log transaksi.
JET_filetypeCheckpoint	File adalah file titik pemeriksaan.
JET_filetypeTempDatabase	File adalah file database sementara.

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_errFeatureNotAvailable	InfoLevel yang diminta JET_DbInfoIsam. Ini tidak didukung.
JET_errBufferTooSmall	Buffer yang diberikan dalam cbMax terlalu kecil untuk informasi yang diinginkan.
JET_errInvalidBufferSize	Buffer yang diberikan dalam cbMax bukan ukuran yang benar untuk informasi yang diinginkan.
JET_errInvalidParameter	Salah satu parameter yang disediakan berisi nilai yang tidak terduga, atau kombinasi beberapa nilai parameter menghasilkan hasil yang tidak terduga. Kesalahan ini akan dikembalikan oleh JetGetDatabaseInfo ketika DBID yang disediakan bukan database yang valid (terlampir). Kesalahan ini akan dikembalikan oleh JetGetDatabaseFileInfo dan JetGetDatabaseInfo ketika InfoLevel yang diminta tidak didukung oleh versi fungsi tersebut.

Jika fungsi ini berhasil, data yang diminta akan dikembalikan dalam buffer output.

Jika fungsi ini gagal, buffer output akan berada dalam status tidak terdefinisi.

Persyaratan

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 JetGetDatabaseFileInfoW (Unicode) dan JetGetDatabaseFileInfoA (ANSI).

Lihat juga

JET_ERR
JET_DBINFOMISC
JET_DBINFOUPGRADE
JetGetDatabaseInfo

Fungsi JetGetDatabaseFileInfo