Compartir a través de


JET_CBTYP

Se aplica a: Windows | Windows Server

JET_CBTYP

El grupo JET_CBTYP de constantes describe todos los puntos posibles de una operación que el motor de base de datos notificará a una aplicación llamando a la función de devolución de llamada JET_CALLBACK . El motor de base de datos pasa una de estas constantes en el parámetro cbtyp de la función de devolución de llamada. El significado de los demás parámetros pasados por el motor de base de datos en esta llamada depende del JET_CBTYP específico pasado.

Windows XP: El grupo JET_CBTYP de constantes se introduce en Windows XP.

Constante o valor

Descripción

JET_cbtypNull
0x00000000

Esta devolución de llamada está reservada y siempre se considera no válida.

JET_cbtypFinalize
0x00000001

Esta devolución de llamada está reservada para su uso futuro.

JET_cbtypBeforeInsert
0x00000002

Esta devolución de llamada se producirá justo antes de que se inserte un nuevo registro en una tabla mediante una llamada a JetUpdate.

El puntero de función para este motivo de devolución de llamada se pasa a JetCreateTableColumnIndex por medio de JET_TABLECREATE o se configura en tiempo de ejecución mediante JetRegisterCallback. Para obtener más información, consulte JET_TABLECREATE o JetRegisterCallback.

Los parámetros de devolución de llamada tendrán los siguientes valores:

  • sesid: sesión que tiene el registro que se va a insertar.

  • dbid: identificador de base de datos de la tabla que contiene el registro que se va a insertar.

  • tableid: cursor que ha preparado el nuevo registro que se va a insertar. Es importante tener en cuenta que el valor de cualquier columna de incremento automático o versión puede no ser correcto en este momento.

  • pvArg1: NULL

  • pvArg2: NULL

  • pvContext: puntero de contexto pasado a JetRegisterCallback o NULL.

  • ulUnused: NULL Si la devolución de llamada devuelve un error, la operación que origina la devolución de llamada producirá un error.

JET_cbtypAfterInsert
0x00000004

Esta devolución de llamada se producirá justo después de que se haya insertado un nuevo registro en una tabla mediante una llamada a JetUpdate , pero antes de que JetUpdate vuelva a su llamador.

El puntero de función para este motivo de devolución de llamada se pasa a JetCreateTableColumnIndex por medio de JET_TABLECREATE o se configura en tiempo de ejecución mediante JetRegisterCallback. Para obtener más información, consulte JET_TABLECREATE o JetRegisterCallback.

Los parámetros de devolución de llamada tendrán los siguientes valores:

  • sesid: sesión que tiene el registro que se acaba de insertar.

  • dbid: identificador de base de datos de la tabla que contiene el registro que se acaba de insertar.

  • tableid: cursor de la tabla en la que se acaba de insertar el registro. Tenga en cuenta que el cursor sigue estando colocado en la misma entrada de índice que estaba en antes de la devolución de llamada de inserción. Tenga en cuenta además que esta entrada de índice puede no estar relacionada de ninguna manera con el registro que se va a insertar.

  • pvArg1: NULL

  • pvArg2: NULL

  • pvContext: puntero de contexto pasado a JetRegisterCallback o NULL.

  • ulUnused: NULL Si la devolución de llamada devuelve un error, se omitirá.

JET_cbtypBeforeReplace
0x00000008

Esta devolución de llamada se producirá justo antes de que se cambie un registro existente en una tabla mediante una llamada a JetUpdate.

El puntero de función para este motivo de devolución de llamada se pasa a JetCreateTableColumnIndex por medio de JET_TABLECREATE o se configura en tiempo de ejecución mediante JetRegisterCallback. Para obtener más información, consulte JET_TABLECREATE o JetRegisterCallback.

Los parámetros de devolución de llamada tendrán los siguientes valores:

  • sesid: sesión que tiene el registro que se va a cambiar.

  • dbid: identificador de base de datos de la tabla que contiene el registro que se va a cambiar.

  • tableid: cursor situado en una entrada de índice asociada al registro que se va a cambiar. Es importante tener en cuenta que el valor de cualquier columna de incremento automático o versión puede no ser correcto en este momento.

  • pvArg1: NULL

  • pvArg2: NULL

  • pvContext: puntero de contexto pasado a JetRegisterCallback o NULL.

  • ulUnused: NULL Si la devolución de llamada devuelve un error, la operación que origina la devolución de llamada producirá un error.

JET_cbtypAfterReplace
0x00000010

Esta devolución de llamada se producirá justo después de que se haya cambiado un registro existente en una tabla mediante una llamada a JetUpdate , pero antes de Que JetUpdate vuelva a su llamador.

El puntero de función para este motivo de devolución de llamada se pasa a JetCreateTableColumnIndex por medio de JET_TABLECREATE o se configura en tiempo de ejecución mediante JetRegisterCallback. Para obtener más información, consulte JET_TABLECREATE o JetRegisterCallback.

Los parámetros de devolución de llamada tendrán los siguientes valores:

  • sesid: sesión que tiene el registro que se acaba de cambiar.

  • dbid: identificador de base de datos de la tabla que contiene el registro que se acaba de cambiar.

  • tableid: cursor situado en una entrada de índice asociada al registro que se acaba de cambiar.

  • pvArg1: NULL

  • pvArg2: NULL

  • pvContext: puntero de contexto pasado a JetRegisterCallback o NULL.

  • ulUnused: NULL Si la devolución de llamada devuelve un error, se omitirá.

JET_cbtypBeforeDelete
0x00000020

Esta devolución de llamada se producirá justo antes de que se elimine un registro existente en una tabla mediante una llamada a JetDelete.

El puntero de función para este motivo de devolución de llamada se pasa a JetCreateTableColumnIndex por medio de JET_TABLECREATE o se configura en tiempo de ejecución mediante JetRegisterCallback. Para obtener más información, consulte JET_TABLECREATE o JetRegisterCallback.

Los parámetros de devolución de llamada tendrán los siguientes valores:

  • sesid: sesión que tiene el registro que se va a eliminar.

  • dbid: identificador de base de datos de la tabla que contiene el registro que se va a eliminar.

  • tableid: cursor situado en una entrada de índice asociada al registro que se va a eliminar.

  • pvArg1: NULL

  • pvArg2: NULL

  • pvContext: puntero de contexto pasado a JetRegisterCallback o NULL.

  • ulUnused: NULL Si la devolución de llamada devuelve un error, la operación que origina la devolución de llamada producirá un error.

JET_cbtypAfterDelete
0x00000040

Esta devolución de llamada se producirá justo después de que se haya eliminado un registro existente en una tabla mediante una llamada a JetDelete , pero antes de que JetDelete vuelva a su llamador.

El puntero de función para este motivo de devolución de llamada se pasa a JetCreateTableColumnIndex por medio de JET_TABLECREATE o se configura en tiempo de ejecución mediante JetRegisterCallback. Para obtener más información, consulte JET_TABLECREATE o JetRegisterCallback.

Los parámetros de devolución de llamada tendrán los siguientes valores:

  • sesid: sesión que tiene el registro que se acaba de eliminar.

  • dbid: identificador de base de datos de la tabla que contiene el registro que se acaba de eliminar.

  • tableid: cursor situado en una entrada de índice asociada al registro que se acaba de eliminar.

  • pvArg1: NULL

  • pvArg2: NULL

  • pvContext: puntero de contexto pasado a JetRegisterCallback o NULL.

  • ulUnused: NULL

Si la devolución de llamada devuelve un error, se omitirá.

JET_cbtypUserDefinedDefaultValue
0x00000080

Esta devolución de llamada se producirá cuando el motor necesite recuperar el valor predeterminado definido por el usuario de una columna de la aplicación. Esta devolución de llamada es básicamente una implementación limitada de JetRetrieveColumn que evalúa la aplicación. Se puede devolver un máximo de un valor de columna para un valor predeterminado definido por el usuario.

El puntero de función para esta razón de devolución de llamada se pasa a JetAddColumn por medio de una estructura de JET_USERDEFINEDDEFAULT o se pasa a JetCreateTableColumnIndex por medio de una estructura de JET_USERDEFINEDDEFAULT en una estructura de JET_COLUMNCREATE en una estructura de JET_TABLECREATE .

Los parámetros de devolución de llamada tendrán los siguientes valores:

  • sesid: sesión que calcula el valor predeterminado definido por el usuario.

  • dbid: el identificador de base de datos de la tabla que contiene el valor predeterminado definido por el usuario.

  • tableid: cursor situado en el registro para el que se recupera el valor predeterminado definido por el usuario.

  • pvArg1: el búfer de salida para el valor predeterminado definido por el usuario

  • pvArg2: en la entrada, este es el tamaño del búfer de salida. En la salida, este es el tamaño real del valor predeterminado definido por el usuario. en cualquier caso, el tamaño es un entero de 32 bits sin signo.

  • pvContext: puntero a un búfer que contiene los datos de usuario especificados en la estructura JET_USERDEFINEDDEFAULT cuando se creó la columna o NULL si no se proporcionó ningún contexto.

  • ulUnused: identificador de columna de la columna para la que se recupera el valor predeterminado definido por el usuario.

Si la devolución de llamada devuelve un error, la operación que origina la devolución de llamada producirá ese error.

Si la devolución de llamada devuelve JET_wrnBufferTruncated, la operación continuará, pero el valor completo no se recuperará durante la devolución de llamada.

Si la devolución de llamada devuelve JET_wrnColumnNull, la operación continuará, pero el valor predeterminado definido por el usuario para la columna es NULL.

JET_cbtypOnlineDefragCompleted
0x00000100

Esta devolución de llamada se producirá cuando se haya detenido la desfragmentación en línea de una base de datos iniciada por JetDefragment debido a que el proceso se está completando o se alcanza el límite de tiempo.

El puntero de función para este motivo de devolución de llamada se pasa a JetDefragment. Para obtener más información, consulte JetDefragment.

Los parámetros de devolución de llamada tendrán los siguientes valores:

  • sesid: sesión que se usa para realizar la desfragmentación en línea para la base de datos o JET_sesidNil para un archivo de streaming.

  • dbid: identificador de base de datos de la base de datos que se desfragmenta o JET_dbidNil para un archivo de streaming.

  • tableid: JET_tableidNil

  • pvArg1: NULL

  • pvArg2: NULL

  • pvContext: NULL

  • ulUnused: NULL

Si la devolución de llamada devuelve un error, se omitirá.

JET_cbtypFreeCursorLS
0x00000200

Esta devolución de llamada se producirá cuando la aplicación necesite limpiar el identificador de contexto del almacenamiento local asociado a un cursor que el motor de base de datos libera. Para obtener más información, consulte JetSetLS.

El puntero de función para este motivo de devolución de llamada se configura mediante JetSetSystemParameter con JET_paramRuntimeCallback.

Los parámetros de devolución de llamada tendrán los siguientes valores:

  • sesid: JET_sesidNil

  • dbid: JET_dbidNil

  • tableid: JET_tableidNil

  • pvArg1: el conjunto de identificadores de contexto mediante JetSetLS

  • pvArg2: NULL

  • pvContext: NULL

  • ulUnused: NULL

Si la devolución de llamada devuelve un error, se omitirá.

JET_cbtypFreeTableLS
0x00000400

Esta devolución de llamada se producirá como resultado de la necesidad de que la aplicación limpie el identificador de contexto del almacenamiento local asociado a una tabla que el motor de base de datos publica. Para obtener más información, consulte JetSetLS.

El puntero de función para este motivo de devolución de llamada se configura mediante JetSetSystemParameter con JET_paramRuntimeCallback.

Los parámetros de devolución de llamada tendrán los siguientes valores:

  • sesid: JET_sesidNil

  • dbid: JET_dbidNil

  • tableid: JET_tableidNil

  • pvArg1: el identificador de contexto establecido mediante JetSetLS.

  • pvArg2: NULL

  • pvContext: NULL

  • ulUnused: NULL

Si la devolución de llamada devuelve un error, se omitirá.

Requisitos

Requisito Value

Cliente

Requiere Windows Vista o Windows XP.

Servidor

Requiere Windows Server 2008 o Windows Server 2003.

Encabezado

Declarado en Esent.h.

Consulte también

JET_CALLBACK