Fonction JetOSSnapshotPrepare
S’applique à : Windows | Windows Serveurs
Fonction JetOSSnapshotPrepare
La fonction JetOSSnapshotPrepare commence les préparations pour une session d’instantané. Une session d’instantané est un intervalle de temps dans lequel le moteur n’émet pas d’e/s d’écriture sur le disque, de sorte que le moteur peut participer à une session d’instantané de volume (lorsqu’il est piloté par un enregistreur d’instantané).
**Windows xp :**JetOSSnapshotPrepare est introduit dans Windows xp.
JET_ERR JET_API JetOSSnapshotPrepare(
__out JET_OSSNAPID* psnapId,
__in const JET_GRBIT grbit
);
Paramètres
psnapId
Identificateur de la session d’instantané à démarrer.
grbit
Options pour cet appel. Ce paramètre peut avoir une combinaison des valeurs suivantes.
Valeur |
Signification |
|---|---|
0 |
Instantané normal. |
JET_bitIncrementalSnapshot |
Seuls les fichiers journaux seront pris. |
JET_bitCopySnapshot |
Instantané de copie (normal ou incrémentiel) sans troncation du journal. |
JET_bitContinueAfterThaw |
La session d’instantané se produit après JetOSSnapshotThaw et nécessite un appel de fonction JetOSSnapshotEnd . |
JET_bitExplicitPrepare |
Aucune instance ne sera préparée par défaut. Windows 7 : JET_bitExplicitPrepare est introduite dans Windows 7. |
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_errInvalidParameter |
Le pointeur d’ID d’instantané a la valeur NULL ou le paramètre Grbit n’est pas valide. |
JET_errOSSnapshotInvalidSequence |
Une session d’instantané est déjà en cours et l’opération n’est pas autorisée à avoir plus d’une session d’instantané à un moment donné. |
Si cette fonction réussit, une session d’instantané est en mesure de démarrer à tout moment avec la phase d’interruption des e/s. L’identificateur de la session est retourné et doit être utilisé dans les appels suivants pour la session d’instantané.
Les instances en cours d’exécution du moteur seront désormais considérées comme faisant partie de la session d’instantané.
Windows Vista : Pour spécifier un sous-ensemble différent d’instances, JetOSSnapshotPrepareInstance peut être appelé.
L’appel de séquence d’API normal est : JetOSSnapshotPrepare, éventuellement suivi d’un ou plusieurs appels à JetOSSnapshotPrepareInstance, puis de JetOSSnapshotFreeze. Une fois le blocage démarré, il peut être arrêté à l’aide de JetOSSnapshotThaw. À tout moment après la préparation, la session d’instantané peut être interrompue soudainement avec JetOSSnapshotAbort.
Si JET_bitContinueAfterThaw est spécifié après JetOSSnapshotThaw, la session d’instantané est conservée (bien que l’e/s reprenne). Cela permet de vérifier la capture instantanée et, si nécessaire, d’activer la troncation du journal à l’aide de JetOSSnapshotTruncateLog et de demander un appel à JetOSSnapshotEnd.
Si cette fonction échoue, aucune modification de l’état du moteur ne se produit.
Remarques
Les entrées du journal des événements seront générées pour les différentes étapes de l’instantané.
Configuration requise
| Condition requise | Valeur |
|---|---|
Client |
requiert Windows Vista ou Windows XP. |
Serveur |
requiert Windows server 2008 ou Windows server 2003. |
En-tête |
Déclaré dans esent. h. |
Bibliothèque |
Utilisez ESENT. lib. |
DLL |
Requiert ESENT.dll. |
Voir aussi
JET_ERR
JET_OSSNAPID
JetOSSnapshotAbort
JetOSSnapshotEnd
JetOSSnapshotFreeze
JetOSSnapshotPrepareInstance
JetOSSnapshotThaw
JetOSSnapshotTruncateLog