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