JetResizeDatabase 函式

適用于： Windows |Windows Server

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

JetResizeDatabase函式是在Windows 8作業系統中引進的。

JET_ERR JET_API JetResizeDatabase(
  __in          JET_SESID sesid,
  __in          JET_DBID dbid,
  __in          unsigned long cpg,
  __out         unsigned long* pcpgActual,
  __in          const JET_GRBIT grbit
);

參數

sesid

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

dbid

將擴充的資料庫。

Cpg

要求的資料庫大小，以分頁為單位。

pcpgActual

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

grbit

指定下表所列之零或多個值的位群組。

值	意義
JET_bitResizeDatabaseOnlyGrow	只增加資料庫。 如果調整大小呼叫會壓縮資料庫，則不執行任何動作。

傳回值

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

傳回碼	Description
JET_errSuccess	作業已成功完成。
JET_errDiskFull	磁片區上的可用空間不足，無法執行成長作業。
JET_errDiskIO	JetSetDatabaseSize函式傳回檔案相關錯誤。 如需其他可能傳回之檔案相關錯誤的詳細資訊，請參閱 JetSetDatabaseSize。

備註

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

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

檔案大小可能不符合 pcpgReal 參數中傳回的頁面數目。 pcpgReal參數中可能不會計算兩個額外的保留頁面。

規格需求

需求	值
用戶端	需要Windows 8。
Server	需要Windows Server 2012。
標頭	在 Esent.h 中宣告。
程式庫	使用 ESENT.lib。
Dll	需要ESENT.dll。

另請參閱

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JET_OBJECTLIST
JetSetDatabaseSize