Fonction JetOSSnapshotTruncateLog

Article
06/12/2023

S’applique à : Windows | Windows Server

Fonction JetOSSnapshotTruncateLog

La fonction JetOSSnapshotTruncateLog active la troncation du journal pour toutes les instances qui font partie de la session instantané.

Windows Vista:JetOSSnapshotTruncateLog est introduit dans Windows Vista.

    JET_ERR JET_API JetOSSnapshotTruncateLog(
      __in          const JET_OSSNAPID snapId,
      __in          const JET_GRBIT grbit
    );

Paramètres

snapId

Identificateur de la session instantané.

grbit

Options de cet appel. Ce paramètre peut avoir une combinaison des valeurs suivantes.

Valeur	Signification
JET_bitAllDatabasesSnapshot	Toutes les bases de données sont attachées afin que le moteur de stockage puisse calculer et effectuer la troncation du journal.
0 (zéro)	Aucune troncation ne se produira.

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_errInvalidGrbit	Le paramètre grbit n’est pas valide.
JET_errOSSnapshotInvalidSequence	La session instantané n’est pas dans l’état dans lequel une troncation peut se produire. Les causes possibles sont : l’appel est effectué après l’expiration du délai d’attente de la session instantané la session a été spécifiée en tant que copie instantané

Code de retour

Description

JET_errSuccess

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

JET_errInvalidGrbit

Le paramètre grbit n’est pas valide.

JET_errOSSnapshotInvalidSequence

La session instantané n’est pas dans l’état dans lequel une troncation peut se produire. Les causes possibles sont :

l’appel est effectué après l’expiration du délai d’attente de la session instantané
la session a été spécifiée en tant que copie instantané

En cas de réussite, les fichiers journaux d’une ou de toutes les instances de la session instantané sont tronqués, si possible.

Notes

Cette fonction doit être appelée uniquement si le instantané a été créé avec l’option JET_bitContinueAfterThaw. Sinon, la session instantané aurait pris fin après l’appel JetOSSnapshotThaw.

Spécifications

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

Voir aussi

Paramètres de gestion des erreurs
Erreurs du moteur de stockage extensible
JET_ERR
JetOSSnapshotEnd
JetOSSnapshotFreeze
JetOSSnapshotPrepare
JetOSSnapshotThaw

Partager via

Fonction JetOSSnapshotTruncateLog