Fonction JetOSSnapshotEnd

S’applique à : Windows | Windows Server

Fonction JetOSSnapshotEnd

La fonction JetOSSnapshotEnd avertit le moteur que la session instantané s’est terminée.

Windows Vista:JetOSSnapshotEnd est introduit dans Windows Vista:.

    JET_ERR JET_API JetOSSnapshotEnd(
      __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
0	Fin réussie de la session instantané.
JET_bitAbortSnapshot	La session instantané a été abandonnée.

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	L’une des options demandées n’est pas valide, utilisée de manière incorrecte ou non implémentée.
JET_errOSSnapshotInvalidSequence	Une session instantané est déjà en cours. Cette opération n’est pas autorisée.
JET_errOSSnapshotInvalidSnapId	L’identificateur de la session instantané n’est pas valide.
JET_errOSSnapshotTimeOut	La session instantané avait un délai d’attente interne avant que cet appel ne se produise. Par conséquent, les opérations d’E/S sont retournées à la normale avant l’exécution de cet appel.

Si cette fonction réussit, une session instantané se termine et le comportement normal du moteur reprend. Une nouvelle session instantané peut être démarrée ultérieurement.

Si cette fonction échoue, le code de retour JET_errOSSnapshotTimeOut retourne et la session instantané actuelle se termine, mais le gel des IE pendant la période de instantané n’a pas été respecté en interne. Pour toutes les autres erreurs, l’état de session instantané n’est pas modifié.

Notes

Cette fonction est appelée uniquement si JetOSSnapshotThaw a été appelé avec JET_bitContinueAfterThaw.

La session instantané doit se terminer pour que la vérification instantané et la troncation du journal se produisent. Les entrées du journal des événements seront générées pour les différentes étapes du instantané.

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
JetOSSnapshotThaw