JetOSSnapshotGetFreezeInfo fonction)

S’applique à : Windows | Windows Serveurs

JetOSSnapshotGetFreezeInfo fonction)

La fonction JetOSSnapshotGetFreezeInfo récupère la liste des instances et des bases de données qui font partie de la session d’instantané à un moment donné.

**Windows vista :**JetOSSnapshotGetFreezeInfo est introduit dans Windows vista.

    JET_ERR JET_API JetOSSnapshotGetFreezeInfo(
      __in          const JET_OSSNAPID snapId,
      __out         unsigned long* pcInstanceInfo,
      __out         JET_INSTANCE_INFO** paInstanceInfo,
      __in          const JET_GRBIT grbit
    );

Paramètres

snapId

Identificateur de la session d’instantané à démarrer.

pcInstanceInfo

Nombre d’instances en cours d’exécution qui font partie de la session d’instantané.

paInstanceInfo

Tableau de structures, une pour chaque instance en cours d’exécution, décrivant l’instance et les bases de données qui en font partie.

grbit

Options pour cet appel. Ce paramètre est réservé à un usage futur. La seule valeur valide est 0 (zéro).

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_errOutOfMemory

La fonction a échoué en raison d’une condition de mémoire insuffisante.

JET_errInvalidParameter

pcInstanceInfo ou PaInstanceInfo a la valeur null.

JET_errOSSnapshotInvalidSnapId

L’identificateur de la session d’instantané n’est pas valide.

JET_errOSSnapshotInvalidSequence

Une session d’instantané n’est pas en cours.

Si cette fonction est réussie, les informations d’instance sont correctement remplies et doivent être libérées ultérieurement en appelant JetFreeBuffer avec le pointeur vers le tableau d’informations d’instance retourné.

Si cette fonction échoue, aucune modification de l’état du moteur ne se produit.

Configuration requise

Condition requise Valeur

Client

requiert Windows Vista.

Serveur

requiert Windows Server 2008.

En-tête

Déclaré dans esent. h.

Bibliothèque

Utilisez ESENT. lib.

DLL

Requiert ESENT.dll.

Unicode

Implémenté en tant que JetOSSnapshotGetFreezeInfoW (Unicode) et JetOSSnapshotGetFreezeInfoA (ANSI).

Voir aussi

Paramètres de gestion des erreurs
erreurs du moteur de Stockage Extensible
JET_ERR
JetFreeBuffer
JetOSSnapshotAbort
JetOSSnapshotFreeze
JetOSSnapshotThaw