Función JetGrowDatabase

Se aplica a: Windows | Windows Server

Función JetGrowDatabase

La función JetGrowDatabase amplía el tamaño de una base de datos que está abierta actualmente.

    JET_ERR JET_API JetGrowDatabase(
      __in          JET_SESID sesid,
      __in          JET_DBID dbid,
      __in          unsigned long cpg,
      __in          unsigned long* pcpgReal
    );

Parámetros

sesid

Contexto de sesión de base de datos que se va a usar para la llamada API.

dbid

La base de datos que se extenderá.

Cpg

Tamaño deseado de la base de datos, en páginas.

pcpgReal

Puntero a un número que recibe el tamaño de la base de datos, en páginas, después de la llamada API. Si se produce un error en la llamada API, el contenido de pcpgReal no está definido.

Valor devuelto

Esta función devuelve el tipo de datos JET_ERR con uno de los siguientes códigos de retorno. Para obtener más información sobre los posibles errores de ESE, vea Extensible Storage Engine Errors and Error Handling Parameters.

Código devuelto

Descripción

JET_errSuccess

La operación se ha completado correctamente.

JET_errDiskFull

No hay suficiente espacio libre en el volumen para realizar la operación de crecimiento.

JET_errDiskIO

JetSetDatabaseSize devolvió un error relacionado con el archivo. Para obtener más información sobre otros errores relacionados con archivos que podrían devolverse, vea JetSetDatabaseSize.

Observaciones

Si se llama a JetGrowDatabase antes de insertar grandes cantidades de datos, el archivo de base de datos se aumentará en una sola operación. Esto reducirá la probabilidad de que el archivo de base de datos se fragmente en el nivel del sistema de archivos y también reduzca el número de veces que el archivo de base de datos debe crecer. Aumentar el archivo de base de datos una vez puede ser más rápido que aumentarlo varias veces.

Actualmente solo se admite el crecimiento del archivo. Para reducir un archivo, use la característica de desfragmentación del programa de utilidad esentutl.exe .

Para establecer el tamaño de una base de datos que no está abierta, consulte JetSetDatabaseSize.

Es posible que el tamaño del archivo no coincida con el número de páginas que se devuelven en pcpgReal. Hay dos páginas reservadas adicionales que podrían no contarse en pcpgReal.

Requisitos

Requisito Value

Cliente

Requiere Windows Vista, Windows XP o Windows 2000 Professional.

Server

Requiere Windows Server 2008, Windows Server 2003 o Windows 2000 Server.

Encabezado

Declarado en Esent.h.

Library

Use ESENT.lib.

DLL

Requiere ESENT.dll.

Consulte también

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JET_OBJECTLIST
JetSetDatabaseSize