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