Función JetResizeDatabase

Se aplica a: Windows | Windows Server

La función JetResizeDatabase extiende o reduce el tamaño de una base de datos que está abierta actualmente.

La función JetResizeDatabase se introdujo en el sistema operativo Windows 8.

JET_ERR JET_API JetResizeDatabase(
  __in          JET_SESID sesid,
  __in          JET_DBID dbid,
  __in          unsigned long cpg,
  __out         unsigned long* pcpgActual,
  __in          const JET_GRBIT grbit
);

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 solicitado de la base de datos, en páginas.

pcpgActual

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 del parámetro pcpgActual no está definido.

grbit

Grupo de bits que especifica cero o más de los valores enumerados en la tabla siguiente.

Valor	Significado
JET_bitResizeDatabaseOnlyGrow	Solo aumente la base de datos. Si la llamada de cambio de tamaño reduciría la base de datos, no haga nada.

Valor devuelto

Esta función devuelve el tipo de datos JET_ERR con uno de los códigos de retorno enumerados en la tabla siguiente. Para obtener más información sobre los posibles errores del motor de almacenamiento extensible (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	La función 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.

Comentarios

Si se llama a la función JetResizeDatabase 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.

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 el parámetro pcpgReal . Es posible que no se cuente dos páginas reservadas adicionales en el parámetro pcpgReal .

Requisitos

Requisito	Value
Cliente	Requiere Windows 8.
Servidor	Requiere Windows Server 2012.
Encabezado	Declarado en Esent.h.
Library	Use ESENT.lib.
Archivo DLL	Requiere ESENT.dll.

Consulte también

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JET_OBJECTLIST
JetSetDatabaseSize