JetGrowDatabase 函式

適用于:Windows |Windows伺服器

JetGrowDatabase 函式

JetGrowDatabase函式會擴充目前開啟的資料庫大小。

    JET_ERR JET_API JetGrowDatabase(
      __in          JET_SESID sesid,
      __in          JET_DBID dbid,
      __in          unsigned long cpg,
      __in          unsigned long* pcpgReal
    );

參數

sesid

要用於 API 呼叫的資料庫會話內容。

dbid

將擴充的資料庫。

Cpg

所需的資料庫大小,以頁面為單位。

pcpgReal

在 API 呼叫之後,接收資料庫大小之數位的指標,以分頁為單位。 如果 API 呼叫失敗, 則 pcpgReal 的內容未定義。

傳回值

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

傳回碼

描述

JET_errSuccess

作業已成功完成。

JET_errDiskFull

磁片區上的可用空間不足,無法執行成長作業。

JET_errDiskIO

JetSetDatabaseSize傳回與檔案相關的錯誤。 如需其他可能傳回之檔案相關錯誤的詳細資訊,請參閱 JetSetDatabaseSize

備註

如果在插入大量資料之前呼叫 JetGrowDatabase ,資料庫檔案將會在一項作業中成長。 這可降低資料庫檔案在檔案系統層級分散的可能性,同時減少資料庫檔案必須成長的次數。 一次資料庫檔案的成長速度可能會比成長數倍快。

目前僅支援檔案成長。 若要壓縮檔案,請使用 esentutl.exe 公用程式程式的重組功能。

若要設定未開啟的資料庫大小,請參閱 JetSetDatabaseSize

檔案大小可能不符合 pcpgReal中傳回的頁面數目。 pcpgReal中可能有兩個其他保留頁面無法計算。

規格需求

需求

用戶端

需要 Windows Vista、Windows XP 或 Windows 2000 Professional。

Server

需要 Windows Server 2008、Windows Server 2003 或 Windows 2000 Server。

標頭

在 Esent.h 中宣告。

程式庫

使用 ESENT.lib。

DLL

需要ESENT.dll。

另請參閱

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JET_OBJECTLIST
JetSetDatabaseSize