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。 |
Server |
需要 Windows Server 2008 或 Windows Server 2003。 |
標頭 |
在 Esent.h 中宣告。 |
程式庫 |
使用 ESENT.lib。 |
Dll |
需要ESENT.dll。 |
另請參閱
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetSetTableSequential
JetStopService