Fonction JetOSSnapshotTruncateLogInstance

S’applique à : Windows | Windows Server

Fonction JetOSSnapshotTruncateLogInstance

La fonction JetOSSnapshotTruncateLogInstance tronque le journal pour un instance spécifié pendant une session instantané.

Windows Vista:JetOSSnapshotTruncateLogInstance est introduit dans Windows Vista.

    JET_ERR JET_API JetOSSnapshotTruncateLogInstance(
      __in          const JET_OSSNAPID snapId,
      __in          JET_INSTANCE instance,
      __in          const JET_GRBIT grbit
    );

Paramètres

snapId

Identificateur de la session instantané.

instance

Le instance qui sera utilisé pour cet appel.

grbit

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

grbit peut être l’une 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 se termine après l’expiration de la session instantané. La session a été spécifiée en tant que copie instantané.

Si cette fonction réussit, les fichiers journaux d’une ou de toutes les instances qui font partie de la session instantané seront tronqués, si possible.

Notes

Cette fonction ne doit être appelée que si le instantané a été créé avec l’option JET_bitContinueAfterThaw. Sinon, la session instantané se termine 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