JetGrowDatabase, fonction

S’applique à : Windows | serveur Windows

JetGrowDatabase, fonction

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, dans les pages.

pcpgReal

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

Valeur de retour

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 extensible Stockage s etparamètres de gestion des erreurs.

Code de retour

Description

JET_errSuccess

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

JET_errDiskFull

Il existe un espace libre insuffisant sur le volume 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 d’insérer 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 devienne fragmenté au niveau du système de fichiers, et réduit également le nombre de fois où le fichier de base de données doit être développé. La croissance du fichier de base de données une fois peut être plus rapide que la 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.

Configuration requise

Condition requise Valeur

Client

Nécessite Windows Vista, Windows XP ou Windows 2000 Professional.

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