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