JetCloseFile 函式

適用于： Windows |Windows Server

JetCloseFile函式會在使用JetReadFile擷取該檔案的資料之後，關閉使用JetOpenFile開啟的檔案。

    JET_ERR JET_API JetCloseFile(
      __in          JET_HANDLE hfFile
    );

hfFile

要讀取之檔案的控制碼。

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

傳回碼	Description
JET_errSuccess	作業已成功完成。
JET_errClientRequestToStopJetService	無法完成作業，因為與會話相關聯之實例上的所有活動因 JetStopService呼叫而停止。
JET_errInstanceUnavailable	無法完成作業，因為與會話相關聯的實例發生嚴重錯誤，需要撤銷所有資料的存取權，以保護該資料的完整性。此錯誤只會由 Windows XP 和更新版本傳回。
JET_errInvalidParameter	提供的其中一個參數包含非預期的值，或包含與另一個參數的值結合時沒有意義的值。當下列情況時，JetCloseFile 可能會發生這種情況：指定的實例控制碼無效， (Windows XP 和更新版本) ，指定的檔案控制代碼無效。
JET_errNoBackup	作業失敗，因為沒有任何外部備份正在進行中。
JET_errNotInitialized	無法完成作業，因為與會話相關聯的實例尚未初始化。
JET_errRestoreInProgress	無法完成作業，因為與會話相關聯的實例上正在進行還原作業。
JET_errRunningInMultiInstanceMode	作業失敗，因為嘗試在舊版模式中使用引擎， (Windows 2000 相容性模式) 實際上已存在多個實例時，只支援一個實例。
JET_errTermInProgress	無法完成作業，因為與會話相關聯的實例正在關閉。

成功時，會關閉檔案控制代碼。如果資料庫檔案已關閉，則會在損毀任何) 時， (相關聯的資料庫修補程式檔案。

失敗時，不會發生任何變更。

資料庫引擎目前一次只支援一個透過 JetOpenFile 開啟的檔案。如果使用 JetOpenFile 開啟檔案控制代碼，則必須使用 JetCloseFile 將其關閉，才能開啟另一個檔案。

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

意見反應