JetIdle 函式

適用于： Windows |Windows Server

JetIdle 函式已無用，而且只應用於測試用途。 JetIdle 可用來執行閒置清除工作，或在 ESE 中檢查版本存放區狀態。

    JET_ERR JET_API JetIdle(
      __in          JET_SESID sesid,
      __in          JET_GRBIT grbit
    );

sesid

將用於此呼叫的會話。

grbit

一組位，其中包含要用於此呼叫的選項，其中包含下列零或多個位：

值	意義
JET_bitIdleCompact	觸發版本存放區的清除。
JET_bitIdleFlushBuffers	保留供未來使用。如果指定此旗標，API 會傳回JET_errInvalidgrbit。
JET_bitIdleStatus	如果版本存放區超過一半已滿，則傳回JET_wrnIdleFull。

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

傳回碼	描述
JET_errSuccess	作業已成功完成。
JET_errInvalidParameter	提供給 API 的 grbit 參數無效。

如果此函式成功，則會觸發適當的作業，或錯誤碼，指出版本存放區的完整程度取決於所提供的 grbit 。

如果此函式失敗，則要求的作業將不會順利完成。

版本存放區會維護 ESE 的快照集隔離機制。如果版本存放區已滿一半，程式可能會關閉長時間執行的交易。如果長時間執行的交易耗盡版本存放區，ESE 將會停止允許對資料庫的寫入作業。

需求	值
用戶端	需要 Windows Vista、Windows XP 或 Windows 2000 Professional。
Server	需要 Windows Server 2008、Windows Server 2003 或 Windows 2000 Server。
標頭	在 Esent.h 中宣告。
程式庫	使用 ESENT.lib。
Dll	需要ESENT.dll。

意見反應