Fungsi JetOSSnapshotPrepareInstance

Berlaku untuk: Windows | Windows Server

Fungsi JetOSSnapshotPrepareInstance

Fungsi JetOSSnapshotPrepareInstance memilih instans tertentu untuk menjadi bagian dari sesi rekam jepret.

Windows Vista:JetOSSnapshotPrepareInstance diperkenalkan di Windows Vista.

JET_ERR JET_API JetOSSnapshotPrepareInstance(
  __in          JET_OSSNAPID snapId,
  __in          JET_INSTANCE instance,
  __in          const JET_GRBIT grbit
);

Parameter

snapId

Pengidentifikasi sesi rekam jepret.

Sebagai contoh

Instans yang akan digunakan untuk panggilan ini.

grbit

Opsi untuk panggilan ini. Parameter ini dicadangkan untuk digunakan di masa mendatang. Satu-satunya nilai yang valid adalah 0 (nol).

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	Penunjuk id rekam jepret adalah NULL atau parameter grbit tidak valid.
JET_errOSSnapshotInvalidSequence	Sesi rekam jepret sudah berlangsung.
JET_errOSSnapshotInvalidSnapId	Pengidentifikasi untuk sesi rekam jepret tidak valid.

Jika fungsi ini berhasil, instans yang ditentukan akan menjadi bagian dari sesi rekam jepret.

Jika fungsi ini gagal, tidak ada perubahan dalam status mesin yang terjadi.

Keterangan

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 mendadak dengan JetOSSnapshotAbort. Entri log peristiwa akan dihasilkan untuk berbagai langkah rekam jepret.

Jika JetOSSnapshotPrepareInstance tidak dipanggil antara awal sesi (JetOSSnapshotPrepare) dan momen pembekuan (JetOSSnapshotFreeze), semua instans yang berjalan di mesin akan membeku dan menjadi bagian dari sesi rekam jepret. Ini terjadi karena dua alasan:

• Ini menyederhanakan kode untuk pengguna yang menginginkan semua instans.

• Ini memungkinkan kompatibilitas mundur untuk penelepon API rekam jepret.

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

Parameter Penanganan Kesalahan
Kesalahan Mesin Penyimpanan yang Dapat Diperluas
JET_ERR
JetOSSnapshotAbort
JetOSSnapshotEnd
JetOSSnapshotFreeze
JetOSSnapshotPrepare
JetOSSnapshotThaw