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