Fonction JetTruncateLogInstance
S’applique à : Windows | Windows Server
Fonction JetTruncateLogInstance
La fonction JetTruncateLogInstance est utilisée lors d’une sauvegarde lancée par JetBeginExternalBackup pour supprimer tous les fichiers journaux des transactions qui ne seront plus nécessaires une fois la sauvegarde en cours terminée.
Windows XP:JetTruncateLogInstance est introduit dans Windows XP.
JET_ERR JET_API JetTruncateLogInstance(
__in JET_INSTANCE instance
);
Paramètres
instance
Instance à utiliser pour cet appel.
Pour Windows 2000, la variante d’API qui accepte ce paramètre n’est pas disponible, car une seule instance est prise en charge. L’utilisation de cette instance globale est implicite dans le cas présent.
Pour Windows XP et les versions ultérieures, la variante d’API qui n’accepte pas ce paramètre ne peut être appelée que lorsque le moteur est en mode hérité (mode de compatibilité Windows 2000) où une seule instance est prise en charge. Dans le cas contraire, l’opération échoue avec JET_errRunningInMultiInstanceMode.
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_errBackupAbortByServer |
Windows Server 2003 : Cette valeur de retour est introduite dans Windows Server 2003. L’opération a échoué, car la sauvegarde externe actuelle a été abandonnée par un appel à JetStopBackup. |
JET_errClientRequestToStopJetService |
L’opération ne peut pas se terminer, car toute l’activité sur le instance associée à la session a cessé à la suite d’un appel à JetStopService. |
JET_errInstanceUnavailable |
L’opération ne peut pas se terminer, car le instance associé à la session a rencontré une erreur irrécupérable qui exige que l’accès à toutes les données soit révoqué pour protéger l’intégrité de ces données. Cette erreur sera retournée uniquement par Windows XP et les versions ultérieures. |
JET_errInvalidBackupSequence |
L’opération de sauvegarde a échoué, car elle a été appelée hors séquence. JetTruncateLog retourne cette erreur s’il existe des handles de fichier en suspens qui ont été créés à l’aide de JetOpenFile pour le instance. |
JET_errInvalidParameter |
L’un des paramètres fournis contenait une valeur inattendue, ou la combinaison de plusieurs paramètres a produit un résultat inattendu. Cela peut se produire pour JetTruncateLog lorsque le instance handle spécifié n’est pas valide. |
JET_errNoBackup |
L’opération a échoué, car aucune sauvegarde externe n’est en cours. |
JET_errNotInitialized |
L’opération ne peut pas se terminer, car le instance associé à la session n’a pas encore été initialisé. |
JET_errRestoreInProgress |
L’opération ne peut pas se terminer, car une opération de restauration est en cours sur le instance associé à la session. |
JET_errRunningInMultiInstanceMode |
L’opération a échoué car une tentative d’utilisation du moteur a été effectuée en mode hérité (mode de compatibilité Windows 2000) où une seule instance est prise en charge alors qu’en fait plusieurs instances existent déjà. |
JET_errTermInProgress |
L’opération ne peut pas se terminer, car le instance associé à la session est en cours d’arrêt. |
Si cette fonction réussit, l’ensemble de fichiers journaux des transactions qui ne seront plus nécessaires une fois la sauvegarde en cours terminée est supprimé. L’ordinateur d’état de sauvegarde est avancé de telle sorte que la sauvegarde des fichiers de base de données n’est plus autorisée. Seuls les fichiers correctifs de base de données et les fichiers journaux des transactions sont autorisés à être ouverts pour la sauvegarde au-delà de ce stade.
Si cette fonction échoue, l’ordinateur d’état de sauvegarde peut être avancé de sorte que la sauvegarde des fichiers de base de données n’est plus autorisée. Un certain nombre de fichiers journaux des transactions peuvent être supprimés qui sont inférieurs au nombre souhaité, mais ils seront toujours supprimés du plus ancien au plus jeune.
Spécifications
| Condition requise | Valeur |
|---|---|
Client |
Nécessite Windows Vista ou Windows XP. |
Serveur |
Nécessite Windows Server 2008 ou Windows Server 2003. |
En-tête |
Déclaré dans Esent.h. |
Bibliothèque |
Utilisez ESENT.lib. |
DLL |
Nécessite ESENT.dll. |
Voir aussi
Fichiers du moteur de stockage extensibles
JET_ERR
JET_INSTANCE
JetBeginExternalBackup
JetOpenFile
JetStopBackup
JetStopService