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 中声明。

Library

使用 ESENT.lib。

DLL

需要ESENT.dll。

另请参阅

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JET_OBJECTLIST
JetSetDatabaseSize