適用于： Windows |Windows Server
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 錯誤的詳細資訊，請參閱 可延伸的儲存引擎錯誤 和 錯誤處理參數。
傳回碼 |
Description |
|---|---|
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