Fonction JetUnregisterCallback

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