fonction de rappel JET_CALLBACK

Article
06/13/2023

S’applique à : Windows | Windows Server

fonction de rappel JET_CALLBACK

La fonction JET_CALLBACK est une fonction de rappel multi-usage utilisée par le moteur de base de données pour informer l’application d’un événement impliquant la défragmentation en ligne et les notifications d’état du curseur.

Consultez JET_CBTYP pour connaître les paramètres spécifiques à utiliser pour les paramètres de cette fonction, car ces paramètres diffèrent en fonction de l’option JET_CBTYP sélectionnée pour une utilisation dans le paramètre cbtyp .

    JET_ERR JET_API* JET_CALLBACK(
      [in]                 JET_SESID sesid,
      [in]                 JET_DBID dbid,
      [in]                 JET_TABLEID tableid,
      [in]                 JET_CBTYP cbtyp,
      [in, out]            void* pvArg1,
      [in, out]            void* pvArg2,
      [in]                 void* pvContext,
      [in]                 JET_API_PTR ulUnused
    );

Paramètres

sesid

Session pour laquelle le rappel est effectué.

dbid

Base de données pour laquelle le rappel est effectué.

tableid

Curseur pour lequel le rappel est effectué.

cbtyp

Point de l’opération auquel le rappel est effectué. Consultez JET_CBTYP pour obtenir la liste des valeurs et la signification des paramètres suivants dans chaque cas.

pvArg1

Paramètre utilisé pour communiquer avec l’application à l’aide du rappel. Consultez JET_CBTYP pour plus d’informations sur l’utilisation de ce paramètre pour chaque rappel pris en charge par le moteur de base de données.

pvArg2

pvContext

ulUnused

Valeur renvoyée

La fonction retourne l’un des codes d’erreur Du moteur de stockage extensible. Pour plus d’informations sur la façon de retourner ces codes en tant que HRESULT, consultez Erreurs du moteur de stockage extensible. En cas de réussite, l’opération qui a émis le rappel peut se poursuivre normalement. Dans certains cas, le rappel peut renvoyer un avertissement qui influence cette opération. Consultez JET_CBTYP pour plus d’informations sur l’utilisation de ces avertissements par l’opération.

En cas d’échec, l’opération qui a émis le rappel peut se poursuivre normalement ou échouer. Consultez JET_CBTYP pour plus d’informations sur l’utilisation du code d’erreur par l’opération.

Notes

Si le rappel transmet un curseur à l’application, il est important de savoir que ce curseur est intentionnellement limité à un ensemble de fonctionnalités plus petit afin d’éviter la récursivité et d’autres laideurs. Les opérations suivantes sont autorisées :

Lorsque vous concevez votre rappel, prenez en compte que même avec ces restrictions, il est toujours possible que le rappel échoue.

Spécifications

Condition requise	Valeur
Client	Nécessite Windows Vista, Windows XP ou Windows 2000 Professionnel.
Serveur	Nécessite Windows Server 2008, Windows Server 2003 ou Windows 2000 Server.
En-tête	Déclaré dans Esent.h.

Voir aussi

JET_API_PTR
JET_DBID
JET_SESID
JET_TABLEID
JET_CBTYP

fonction de rappel JET_CALLBACK