Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
S’applique à : Windows | Windows Server
Fonction JetUnregisterCallback
La fonction JetUnregisterCallback permet à l’application de configurer le moteur de base de données pour arrêter l’émission de notifications à l’application, comme demandé précédemment via JetRegisterCallback.
Windows XP:JetUnregisterCallback est introduit dans Windows XP.
JET_ERR JET_API JetUnregisterCallback(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__in JET_CBTYP cbtyp,
__in JET_HANDLE hCallbackId
);
Paramètres
sesid
Session à utiliser pour cet appel.
tableid
Curseur à utiliser pour cet appel.
cbtyp
Masque de bits composé des raisons de rappel pour lesquelles l’application ne souhaite plus recevoir de notifications.
Pour créer ce masque de bits, vous devez simplement ou ensemble des raisons de rappel valides à partir de l’énumération JET_CBTYP .
hCallbackId
Handle du rappel inscrit retourné par JetRegisterCallback.
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_errClientRequestToStopJetService |
L’opération ne peut pas se terminer, car toutes les activités sur le instance associée à la session ont cessé à la suite d’un appel à JetStopService. |
JET_errInstanceUnavailable |
L’opération ne peut pas se terminer, car le instance associé à la session a rencontré une erreur irrécupérable qui exige que l’accès à toutes les données soit révoqué pour protéger l’intégrité de ces données. Windows XP : Cette valeur de retour est introduite dans Windows XP. |
JET_errNotInitialized |
L’opération ne peut pas se terminer, car le instance associé à la session n’a pas encore été initialisé. |
JET_errRestoreInProgress |
L’opération ne peut pas se terminer, car une opération de restauration est en cours sur le instance associé à la session. |
JET_errSessionSharingViolation |
La même session ne peut pas être utilisée pour plusieurs threads en même temps. Windows XP : Cette valeur de retour est introduite dans Windows XP. |
JET_errTermInProgress |
L’opération ne peut pas se terminer, car le instance associé à la session est en cours d’arrêt. |
Si cette fonction réussit, le rappel spécifié est désinscrit pour les raisons de rappel données avec la table associée au curseur donné. Aucune modification de l’état de la base de données ne se produira.
Si cette fonction échoue, le rappel spécifié ne sera pas désinscrit. Aucune modification de l’état de la base de données ne se produira.
Notes
Le masque de bits donné doit correspondre exactement au masque de bits spécifié lors de l’inscription du rappel. Le moteur de base de données ne prend actuellement pas en charge la suppression d’un sous-ensemble de ces notifications et ne retourne pas d’erreur lorsque cette opération est tentée.
Spécifications
| Condition requise | Valeur |
|---|---|
Client |
Nécessite Windows Vista ou Windows XP. |
Serveur |
Nécessite Windows Server 2008 ou Windows Server 2003. |
En-tête |
Déclaré dans Esent.h. |
Bibliothèque |
Utilisez ESENT.lib. |
DLL |
Nécessite ESENT.dll. |
Voir aussi
JET_CBTYP
JET_ERR
JET_HANDLE
JET_SESID
JET_TABLEID
JetRegisterCallback
JetStopService