Fonction JetGrowDatabase

S’applique à : Windows | Windows Server

Fonction JetGrowDatabase

La fonction JetGrowDatabase étend la taille d’une base de données actuellement ouverte.

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

Paramètres

sesid

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

dbid

Base de données qui sera étendue.

Cpg

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

pcpgReal

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 de pcpgReal n’est pas défini.

Valeur renvoyée

Cette fonction retourne le type de données JET_ERR avec l’un des codes de retour suivants. Pour plus d’informations sur les erreurs ESE 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 sur le volume est insuffisant pour effectuer l’opération de croissance.
JET_errDiskIO	Une erreur liée au fichier a été retournée par JetSetDatabaseSize. Pour plus d’informations sur les autres erreurs liées aux fichiers qui peuvent être retournées, consultez JetSetDatabaseSize.

Notes

Si JetGrowDatabase est appelé avant l’insertion de grandes quantités de données, le fichier de base de données est développé en une seule opération. Cela réduit la probabilité que le fichier de base de données soit fragmenté au niveau du système de fichiers et le nombre de fois où le fichier de base de données doit être augmenté. La croissance du fichier de base de données une fois peut être plus rapide que sa croissance plusieurs fois.

Seule la croissance du fichier est actuellement prise en charge. Pour réduire un fichier, utilisez la fonctionnalité de défragmentation du programme utilitaire esentutl.exe .

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 pcpgReal. Il existe deux pages réservées supplémentaires qui peuvent ne pas être comptabilisées dans pcpgReal.

Spécifications

Condition requise	Valeur
Client	Nécessite Windows Vista, Windows XP ou Windows 2000 Professionnel.
Serveur	Nécessite Windows Server 2008, Windows Server 2003 ou Windows 2000 Server.
En-tête	Déclaré dans Esent.h.
Bibliothèque	Utilisez ESENT.lib.
DLL	Nécessite ESENT.dll.

Voir aussi

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JET_OBJECTLIST
JetSetDatabaseSize