JetResizeDatabase fonction)

S’applique à : Windows | Windows Serveurs

La fonction JetResizeDatabase étend ou réduit la taille d’une base de données qui est actuellement ouverte.

la fonction JetResizeDatabase a été introduite dans le système d’exploitation 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
);

Paramètres

sesid

Contexte de la session de base de données à utiliser pour l’appel d’API.

dbid

Base de données qui sera étendue.

CPG

Taille demandée de la base de données, en pages.

pcpgActual

Pointeur vers un nombre qui reçoit la taille de la base de données, en pages, après l’appel d’API. Si l’appel d’API échoue, le contenu du paramètre pcpgActual n’est pas défini.

grbit

Groupe de bits qui spécifie zéro, une ou plusieurs des valeurs énumérées dans le tableau suivant.

Valeur

Signification

JET_bitResizeDatabaseOnlyGrow

Développez uniquement la base de données. Si l’appel Resize réduit la base de données, ne faites rien.

Valeur retournée

Cette fonction retourne le type de données JET_ERR avec l’un des codes de retour énumérés dans le tableau suivant. pour plus d’informations sur les erreurs ESE (extensible Stockage engine) possibles, consultez erreurs du moteur de Stockage extensible et paramètres de gestion des erreurs.

Code de retour

Description

JET_errSuccess

L’opération s’est terminée avec succès.

JET_errDiskFull

L’espace libre est insuffisant sur le volume pour effectuer l’opération d’augmentation.

JET_errDiskIO

Une erreur liée à un fichier a été retournée par la fonction JetSetDatabaseSize . Pour plus d’informations sur les autres erreurs liées aux fichiers qui peuvent être retournées, consultez JetSetDatabaseSize.

Remarques

Si la fonction JetResizeDatabase est appelée avant l’insertion de grandes quantités de données, le fichier de base de données sera augmenté en une seule opération. Cela permet de réduire la probabilité que le fichier de base de données soit fragmenté au niveau du système de fichiers et de réduire également le nombre de fois où le fichier de base de données doit être augmenté. La croissance du fichier de base de données peut être plus rapide que la croissance à plusieurs reprises.

Pour définir la taille d’une base de données qui n’est pas ouverte, consultez JetSetDatabaseSize.

La taille du fichier peut ne pas correspondre au nombre de pages retournées dans le paramètre pcpgReal . Deux pages réservées supplémentaires peuvent ne pas être comptées dans le paramètre pcpgReal .

Configuration requise

Condition requise Valeur

Client

Requiert Windows 8.

Serveur

Requiert Windows Server 2012.

En-tête

Déclaré dans esent. h.

Bibliothèque

Utilisez ESENT. lib.

DLL

Requiert ESENT.dll.

Voir aussi

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JET_OBJECTLIST
JetSetDatabaseSize