JetOSSnapshotEnd 函式

適用于：Windows |Windows伺服器

JetOSSnapshotEnd函式會通知引擎快照集會話已完成。

Windows Vista：JetOSSnapshotEnd是在 Windows Vista：中引進。

    JET_ERR JET_API JetOSSnapshotEnd(
      __in          const JET_OSSNAPID snapId,
      __in          const JET_GRBIT grbit
    );

snapId

快照集會話的識別碼。

grbit

這個呼叫的選項。此參數可以結合下列值。

值	意義
0	快照集會話的成功結束。
JET_bitAbortSnapshot	快照集會話已中止。

此函式會傳回具有下列其中一個傳回碼的 JET_ERR 資料類型。如需可能 ESE 錯誤的詳細資訊，請參閱可延伸儲存體引擎錯誤和錯誤處理參數。

傳回碼	描述
JET_errSuccess	作業已成功完成。
JET_errInvalidGrbit	要求的其中一個選項無效、不正確使用或未實作。
JET_errOSSnapshotInvalidSequence	快照集會話已在進行中。這是不允許的。
JET_errOSSnapshotInvalidSnapId	快照集會話的識別碼無效。
JET_errOSSnapshotTimeOut	快照集會話在發生此呼叫之前有內部逾時。因此，在進行此呼叫之前，IO 作業會傳回正常狀態。

如果此函式成功，快照集會話將會完成，且正常引擎行為將會繼續。稍後可以啟動新的快照集會話。

如果此函式失敗，JET_errOSSnapshotTimeOut傳回碼會傳回，而目前的快照集會話會結束，但在快照集期間內未遵守 IO 凍結。對於所有其他錯誤，快照集會話狀態將不會變更。

快照集會話必須完成，才能進行快照集驗證和記錄截斷。系統會針對快照集的不同步驟產生事件記錄專案。