JetOSSnapshotEnd 函式
適用于: Windows |Windows Server
JetOSSnapshotEnd 函式
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 錯誤的詳細資訊,請參閱 可延伸的儲存引擎錯誤 和 錯誤處理參數。
傳回碼 |
Description |
---|---|
JET_errSuccess |
作業已成功完成。 |
JET_errInvalidGrbit |
要求的其中一個選項無效、未正確使用或未實作。 |
JET_errOSSnapshotInvalidSequence |
快照集會話正在進行中。 這是不允許的。 |
JET_errOSSnapshotInvalidSnapId |
快照集會話的識別碼無效。 |
JET_errOSSnapshotTimeOut |
快照集會話在發生此呼叫之前有內部逾時。 因此,IO 作業會在進行此呼叫之前傳回正常狀態。 |
如果此函式成功,快照集會話將會完成,而且一般引擎行為將會繼續。 稍後可以啟動新的快照集會話。
如果此函式失敗,JET_errOSSnapshotTimeOut傳回碼會傳回,而目前的快照集會話會結束,但快照集期間內未遵守 IO 凍結。 對於所有其他錯誤,快照集會話狀態將不會變更。
備註
只有在使用 JET_bitContinueAfterThaw 呼叫 JetOSSnapshotThaw 時,才會呼叫此函式。
快照集會話必須完成,才能進行快照集驗證和記錄截斷。 系統會針對快照集的不同步驟產生事件記錄檔專案。
規格需求
需求 | 值 |
---|---|
用戶端 |
需要 Windows Vista。 |
Server |
需要 Windows Server 2008。 |
標頭 |
在 Esent.h 中宣告。 |
程式庫 |
使用 ESENT.lib。 |
Dll |
需要ESENT.dll。 |