función de devolución de llamada de JET_CALLBACK

Artículo
06/13/2023

Se aplica a: Windows | Windows Server

función de devolución de llamada de JET_CALLBACK

La función JET_CALLBACK es una función de devolución de llamada de varios propósitos que usa el motor de base de datos para informar a la aplicación de un evento que implica notificaciones de estado de cursor y desfragmentación en línea.

Consulte JET_CBTYP para obtener una configuración específica que se usará para los parámetros de esta función, ya que esta configuración variará en función de la opción JET_CBTYP seleccionada para su uso en el parámetro 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
    );

Parámetros

sesid

Sesión para la que se realiza la devolución de llamada.

dbid

Base de datos para la que se realiza la devolución de llamada.

tableid

Cursor para el que se realiza la devolución de llamada.

cbtyp

Punto de la operación en la que se realiza la devolución de llamada. Consulte JET_CBTYP para obtener una lista de valores y el significado de los parámetros siguientes en cada caso.

pvArg1

Parámetro que se usa para comunicarse con la aplicación mediante la devolución de llamada. Consulte JET_CBTYP para obtener información sobre el uso de este parámetro para cada devolución de llamada compatible con el motor de base de datos.

pvArg2

pvContext

ulUnused

Valor devuelto

La función devuelve uno de los códigos de error del motor de almacenamiento extensible. Para obtener información sobre cómo devolver estos códigos como HRESULT, consulte Errores de motor de almacenamiento extensible. Si se ejecuta correctamente, la operación que emitió la devolución de llamada puede continuar con normalidad. En algunos casos, la devolución de llamada puede devolver una advertencia que influye en esa operación. Consulte JET_CBTYP para obtener información sobre el uso de estas advertencias por la operación.

En caso de error, la operación que emitió la devolución de llamada puede continuar normalmente o puede producir un error. Consulte JET_CBTYP para obtener información sobre el uso del código de error por la operación.

Observaciones

Si la devolución de llamada pasa un cursor a la aplicación, es importante saber que este cursor se limita intencionadamente a un conjunto más pequeño de funcionalidades para evitar la recursividad y otra fealdad. Se permiten las siguientes operaciones:

Al diseñar la devolución de llamada, tenga en cuenta que, incluso con estas restricciones, todavía es posible que se produzca un error en la devolución de llamada.

Requisitos

Requisito	Value
Cliente	Requiere Windows Vista, Windows XP o Windows 2000 Professional.
Servidor	Requiere Windows Server 2008, Windows Server 2003 o Windows 2000 Server.
Encabezado	Declarado en Esent.h.

Consulte también

JET_API_PTR
JET_DBID
JET_SESID
JET_TABLEID
JET_CBTYP

función de devolución de llamada de JET_CALLBACK