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