JetResetTableSequential 函式

適用于：Windows |Windows伺服器

JetResetTableSequential 函式

JetResetTableSequential函式會通知資料庫引擎應用程式不再掃描包含指定資料指標的整個目前索引。 此呼叫會反轉 JetSetTableSequential所傳送的通知。

Windows XP：JetResetTableSequential是在 Windows XP 中引進。

    JET_ERR JET_API JetResetTableSequential(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          JET_GRBIT grbit
    );

參數

sesid

要用於這個呼叫的會話。

tableid

要用於這個呼叫的資料指標。

grbit

保留供未來使用。

傳回值

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

傳回碼	描述
JET_errSuccess	作業已成功完成。
JET_errClientRequestToStopJetService	因為與會話相關聯的實例上的所有活動因為對 JetStopService的呼叫而停止，所以無法完成作業。
JET_errInstanceUnavailable	無法完成作業，因為與會話相關聯的實例發生嚴重錯誤，要求撤銷所有資料的存取權以保護該資料的完整性。 此錯誤只會由Windows XP 和更新版本傳回。
JET_errNotInitialized	無法完成作業，因為與會話相關聯的實例尚未初始化。
JET_errRestoreInProgress	因為與會話相關聯的實例上正在進行還原作業，所以無法完成作業。
JET_errTermInProgress	因為與會話相關聯的實例正在關閉，所以無法完成作業。

成功時，資料指標的目前索引不再針對整個索引的循序掃描進行優化。 不會變更資料庫狀態。

失敗時，不會變更資料指標的組態。 不會變更資料庫狀態。

備註

針對先前未由 JetSetTableSequential呼叫所設定的資料指標進行此呼叫是安全的。

規格需求

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

另請參閱

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetSetTableSequential
JetStopService