Fungsi JetOSSnapshotPrepare

Artikel
06/13/2023

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

Bagikan melalui

Fungsi JetOSSnapshotPrepare