Fungsi JetOSSnapshotPrepare
Berlaku untuk: Windows | Windows Server
Fungsi JetOSSnapshotPrepare
Fungsi JetOSSnapshotPrepare memulai persiapan untuk sesi rekam jepret. Sesi rekam jepret adalah interval waktu singkat di mana mesin tidak mengeluarkan IO tulis apa pun ke disk, sehingga mesin dapat berpartisipasi dalam sesi rekam jepret volume (saat didorong oleh penulis rekam jepret).
Windows XP:JetOSSnapshotPrepare diperkenalkan di Windows XP.
JET_ERR JET_API JetOSSnapshotPrepare(
__out JET_OSSNAPID* psnapId,
__in const JET_GRBIT grbit
);
Parameter
psnapId
Pengidentifikasi sesi rekam jepret yang akan dimulai.
grbit
Opsi untuk panggilan ini. Parameter ini dapat memiliki kombinasi nilai berikut.
Value |
Makna |
---|---|
0 |
Rekam jepret normal. |
JET_bitIncrementalSnapshot |
Hanya file log yang akan diambil. |
JET_bitCopySnapshot |
Salinan bayangan (normal atau bertahap) tanpa pemotongan log. |
JET_bitContinueAfterThaw |
Sesi rekam jepret terjadi setelah JetOSSnapshotThaw dan akan memerlukan panggilan fungsi JetOSSnapshotEnd . |
JET_bitExplicitPrepare |
Tidak ada instans yang akan disiapkan secara default. Windows 7: JET_bitExplicitPrepare diperkenalkan di Windows 7. |
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.
Mengembalikan kode |
Deskripsi |
---|---|
JET_errSuccess |
Operasi berhasil diselesaikan. |
JET_errInvalidParameter |
Penunjuk ID rekam jepret adalah NULL atau parameter grbit tidak valid. |
JET_errOSSnapshotInvalidSequence |
Sesi rekam jepret sudah berlangsung dan operasi tidak diizinkan untuk memiliki lebih dari satu sesi rekam jepret pada waktu tertentu. |
Jika fungsi ini berhasil, sesi rekam jepret akan dapat dimulai kapan saja dengan fase pembenahan IO. Pengidentifikasi untuk sesi akan dikembalikan dan harus digunakan dalam panggilan berikutnya untuk sesi rekam jepret.
Instans mesin yang sedang berjalan sekarang akan dianggap sebagai bagian dari sesi rekam jepret.
Windows Vista: Untuk menentukan subset instans yang berbeda, JetOSSnapshotPrepareInstance dapat dipanggil.
Panggilan urutan API normal adalah: JetOSSnapshotPrepare, secara opsional diikuti oleh satu atau beberapa panggilan ke JetOSSnapshotPrepareInstance, lalu diikuti oleh JetOSSnapshotFreeze. Setelah pembekuan dimulai, dapat dihentikan menggunakan JetOSSnapshotThaw. Kapan saja setelah persiapan, sesi rekam jepret dapat dihentikan secara tiba-tiba dengan JetOSSnapshotAbort.
Jika JET_bitContinueAfterThaw ditentukan setelah JetOSSnapshotThaw, sesi rekam jepret akan tetap ada (meskipun I/O akan dilanjutkan). Ini akan mengaktifkan verifikasi rekam jepret, dan jika diperlukan, akan mengaktifkan pemotongan log menggunakan JetOSSnapshotTruncateLog dan akan memerlukan panggilan ke JetOSSnapshotEnd.
Jika fungsi ini gagal, tidak ada perubahan dalam status mesin yang terjadi.
Keterangan
Entri log peristiwa akan dihasilkan untuk berbagai langkah rekam jepret.
Persyaratan
Persyaratan | Value |
---|---|
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 |
Memerlukan ESENT.dll. |
Lihat Juga
JET_ERR
JET_OSSNAPID
JetOSSnapshotAbort
JetOSSnapshotEnd
JetOSSnapshotFreeze
JetOSSnapshotPrepareInstance
JetOSSnapshotThaw
JetOSSnapshotTruncateLog