JetGrowDatabase 函数

适用于: 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
    );

parameters

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 专业版。

服务器

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

标头

在 Esent.h 中声明。

Library

使用 ESENT.lib。

DLL

需要ESENT.dll。

另请参阅

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JET_OBJECTLIST
JetSetDatabaseSize