JetResetTableSequential 函式

適用于: Windows |Windows Server

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 錯誤的詳細資訊,請參閱可延伸 儲存引擎錯誤錯誤處理參數

傳回碼

Description

JET_errSuccess

作業已成功完成。

JET_errClientRequestToStopJetService

無法完成作業,因為與該會話相關聯之實例上的所有活動都不是呼叫 JetStopService的結果。

JET_errInstanceUnavailable

無法完成作業,因為與會話相關聯的實例發生嚴重錯誤,需要撤銷所有資料的存取權,以保護該資料的完整性。 只有 Windows XP 和更新版本才會傳回此錯誤。

JET_errNotInitialized

無法完成作業,因為與會話相關聯的實例尚未初始化。

JET_errRestoreInProgress

無法完成作業,因為與會話相關聯的實例正在進行還原作業。

JET_errTermInProgress

無法完成作業,因為與會話相關聯的實例正在關閉。

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

失敗時,將不會變更資料指標的設定。 不會變更資料庫狀態。

備註

您可以安全地針對之前未透過呼叫 JetSetTableSequential設定的資料指標進行此呼叫。

規格需求

用戶端

需要 Windows Vista 或 Windows XP。

伺服器

需要 Windows Server 2008 或 Windows Server 2003。

標頭

宣告于 Esent. h 中。

程式庫

使用 ESENT。

DLL

需要 ESENT.dll。

另請參閱

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetSetTableSequential
JetStopService