Fonction JetResizeDatabase

Article
06/12/2023

S’applique à : Windows | Windows Server

La fonction JetResizeDatabase étend ou réduit la taille d’une base de données 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 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 ou plus des valeurs répertoriées dans le tableau suivant.

Valeur	Signification
JET_bitResizeDatabaseOnlyGrow	Développez uniquement la base de données. Si l’appel de redimensionnement 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 répertoriés dans le tableau suivant. Pour plus d’informations sur les erreurs possibles du moteur de stockage extensible (ESE), 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 la fonction JetSetDatabaseSize . Pour plus d’informations sur les autres erreurs liées aux fichiers qui peuvent être retournées, consultez JetSetDatabaseSize.

Notes

Si la fonction JetResizeDatabase est appelée 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 soit fragmenté au niveau du système de fichiers, ainsi que le nombre de fois où le fichier de base de données doit être augmenté. Augmenter le fichier de base de données une fois peut être plus rapide que plusieurs fois.

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 .

Spécifications

Condition requise	Valeur
Client	Nécessite Windows 8.
Serveur	Nécessite Windows Server 2012.
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

Partager via