Fonction JetOSSnapshotGetFreezeInfo

S’applique à : Windows | Windows Server

Fonction JetOSSnapshotGetFreezeInfo

La fonction JetOSSnapshotGetFreezeInfo récupère la liste des instances et des bases de données qui font partie de la session 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 instantané à démarrer.

pcInstanceInfo

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

paInstanceInfo

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

grbit

Options de 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 mémoire insuffisante.
JET_errInvalidParameter	pcInstanceInfo ou paInstanceInfo a lavaleur NULL.
JET_errOSSnapshotInvalidSnapId	L’identificateur de la session instantané n’est pas valide.
JET_errOSSnapshotInvalidSequence	Une session de instantané n’est pas en cours.

Si cette fonction réussit, les informations instance sont correctement renseignées et doivent être libérées ultérieurement en appelant JetFreeBuffer avec le pointeur vers le tableau d’informations instance qui a été retourné.

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

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.
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