JET_CBTYP

  • Artigo

Aplica-se a: Windows | Windows Server

JET_CBTYP

O grupo de constantes JET_CBTYP descreve todos os pontos possíveis em uma operação que o mecanismo de banco de dados notificará um aplicativo chamando a função de retorno de chamada JET_CALLBACK . O mecanismo de banco de dados passa uma dessas constantes no parâmetro cbtyp da função de retorno de chamada. O significado dos outros parâmetros passados pelo mecanismo de banco de dados nessa chamada depende do JET_CBTYP específico passado.

Windows XP: O grupo JET_CBTYP de constantes é introduzido no Windows XP.

Constante/valor

Descrição

JET_cbtypNull
0x00000000

Esse retorno de chamada é reservado e sempre considerado inválido.

JET_cbtypFinalize
0x00000001

Esse retorno de chamada é reservado para uso futuro.

JET_cbtypBeforeInsert
0x00000002

Esse retorno de chamada ocorrerá pouco antes de um novo registro ser inserido em uma tabela por uma chamada para JetUpdate.

O ponteiro de função para esse motivo de retorno de chamada é passado para JetCreateTableColumnIndex por meio de JET_TABLECREATE ou é configurado em runtime por meio de JetRegisterCallback. Para obter mais informações, consulte JET_TABLECREATE ou JetRegisterCallback.

Os parâmetros de retorno de chamada terão os seguintes valores:

  • sesid: a sessão que tem o registro a ser inserido.

  • dbid: a ID do banco de dados da tabela que contém o registro a ser inserido.

  • tableid: o cursor que preparou o novo registro a ser inserido. É importante observar que o valor de qualquer versão ou colunas de incremento automático pode não estar correto no momento.

  • pvArg1: NULL

  • pvArg2: NULL

  • pvContext: o ponteiro de contexto passado para JetRegisterCallback ou NULL.

  • ulUnused: NULL Se um erro for retornado pelo retorno de chamada, a operação que originou o retorno de chamada falhará com esse erro.

JET_cbtypAfterInsert
0x00000004

Esse retorno de chamada ocorrerá logo após um novo registro ter sido inserido em uma tabela por uma chamada para JetUpdate , mas antes que JetUpdate retorne ao chamador.

O ponteiro de função para esse motivo de retorno de chamada é passado para JetCreateTableColumnIndex por meio de JET_TABLECREATE ou é configurado em runtime por meio de JetRegisterCallback. Para obter mais informações, consulte JET_TABLECREATE ou JetRegisterCallback.

Os parâmetros de retorno de chamada terão os seguintes valores:

  • sesid: a sessão que tem o registro que acabou de ser inserido.

  • dbid: a ID do banco de dados da tabela que contém o registro que acabou de ser inserido.

  • tableid: um cursor na tabela na qual o registro que acabou de ser inserido. Observe que o cursor ainda está posicionado na mesma entrada de índice que era no retorno de chamada antes de inserir. Observe ainda que essa entrada de índice pode não estar relacionada de forma alguma ao registro que está sendo inserido.

  • pvArg1: NULL

  • pvArg2: NULL

  • pvContext: o ponteiro de contexto passado para JetRegisterCallback ou NULL.

  • ulUnused: NULL Se um erro for retornado pelo retorno de chamada, ele será ignorado.

JET_cbtypBeforeReplace
0x00000008

Esse retorno de chamada ocorrerá pouco antes de um registro existente em uma tabela ser alterado por uma chamada para JetUpdate.

O ponteiro de função para esse motivo de retorno de chamada é passado para JetCreateTableColumnIndex por meio de JET_TABLECREATE ou é configurado em runtime por meio de JetRegisterCallback. Para obter mais informações, consulte JET_TABLECREATE ou JetRegisterCallback.

Os parâmetros de retorno de chamada terão os seguintes valores:

  • sesid: a sessão que tem o registro a ser alterado.

  • dbid: a ID do banco de dados da tabela que contém o registro a ser alterado.

  • tableid: um cursor posicionado em uma entrada de índice associada ao registro a ser alterado. É importante observar que o valor de qualquer versão ou colunas de incremento automático pode não estar correto no momento.

  • pvArg1: NULL

  • pvArg2: NULL

  • pvContext: o ponteiro de contexto passado para JetRegisterCallback ou NULL.

  • ulUnused: NULL Se um erro for retornado pelo retorno de chamada, a operação que originou o retorno de chamada falhará com esse erro.

JET_cbtypAfterReplace
0x00000010

Esse retorno de chamada ocorrerá logo após um registro existente em uma tabela ter sido alterado por uma chamada para JetUpdate , mas antes de JetUpdate retornar ao chamador.

O ponteiro de função para esse motivo de retorno de chamada é passado para JetCreateTableColumnIndex por meio de JET_TABLECREATE ou é configurado em runtime por meio de JetRegisterCallback. Para obter mais informações, consulte JET_TABLECREATE ou JetRegisterCallback.

Os parâmetros de retorno de chamada terão os seguintes valores:

  • sesid: a sessão que tem o registro que acabou de ser alterado.

  • dbid: a ID do banco de dados da tabela que contém o registro que acabou de ser alterado.

  • tableid: um cursor posicionado em uma entrada de índice associada ao registro que acabou de ser alterado.

  • pvArg1: NULL

  • pvArg2: NULL

  • pvContext: o ponteiro de contexto passado para JetRegisterCallback ou NULL.

  • ulUnused: NULL Se um erro for retornado pelo retorno de chamada, ele será ignorado.

JET_cbtypBeforeDelete
0x00000020

Esse retorno de chamada ocorrerá pouco antes de um registro existente em uma tabela ser excluído por uma chamada para JetDelete.

O ponteiro de função para esse motivo de retorno de chamada é passado para JetCreateTableColumnIndex por meio de JET_TABLECREATE ou é configurado em runtime por meio de JetRegisterCallback. Para obter mais informações, consulte JET_TABLECREATE ou JetRegisterCallback.

Os parâmetros de retorno de chamada terão os seguintes valores:

  • sesid: a sessão que tem o registro a ser excluído.

  • dbid: a ID do banco de dados da tabela que contém o registro a ser excluído.

  • tableid: um cursor posicionado em uma entrada de índice associada ao registro a ser excluído.

  • pvArg1: NULL

  • pvArg2: NULL

  • pvContext: o ponteiro de contexto passado para JetRegisterCallback ou NULL.

  • ulUnused: NULL Se um erro for retornado pelo retorno de chamada, a operação que originou o retorno de chamada falhará com esse erro.

JET_cbtypAfterDelete
0x00000040

Esse retorno de chamada ocorrerá logo após um registro existente em uma tabela ter sido excluído por uma chamada para JetDelete , mas antes que JetDelete retorne ao chamador.

O ponteiro de função para esse motivo de retorno de chamada é passado para JetCreateTableColumnIndex por meio de JET_TABLECREATE ou é configurado em runtime por meio de JetRegisterCallback. Para obter mais informações, consulte JET_TABLECREATE ou JetRegisterCallback.

Os parâmetros de retorno de chamada terão os seguintes valores:

  • sesid: a sessão que tem o registro que acabou de ser excluído.

  • dbid: a ID do banco de dados da tabela que contém o registro que acabou de ser excluído.

  • tableid: um cursor posicionado em uma entrada de índice associada ao registro que acabou de ser excluído.

  • pvArg1: NULL

  • pvArg2: NULL

  • pvContext: o ponteiro de contexto passado para JetRegisterCallback ou NULL.

  • ulUnused: NULL

Se um erro for retornado pelo retorno de chamada, ele será ignorado.

JET_cbtypUserDefinedDefaultValue
0x00000080

Esse retorno de chamada ocorrerá quando o mecanismo precisar recuperar o valor padrão definido pelo usuário de uma coluna do aplicativo. Esse retorno de chamada é essencialmente uma implementação limitada de JetRetrieveColumn que é avaliada pelo aplicativo. Um valor máximo de uma coluna pode ser retornado para um valor padrão definido pelo usuário.

O ponteiro de função para esse motivo de retorno de chamada é passado para JetAddColumn por meio de uma estrutura JET_USERDEFINEDDEFAULT ou passado para JetCreateTableColumnIndex por meio de uma estrutura JET_USERDEFINEDDEFAULT em uma estrutura JET_COLUMNCREATE em uma estrutura JET_TABLECREATE .

Os parâmetros de retorno de chamada terão os seguintes valores:

  • sesid: a sessão que está computando o valor padrão definido pelo usuário

  • dbid: a ID do banco de dados da tabela que contém o valor padrão definido pelo usuário

  • tableid: um cursor posicionado no registro para o qual o valor padrão definido pelo usuário está sendo recuperado

  • pvArg1: o buffer de saída para o valor padrão definido pelo usuário

  • pvArg2: na entrada, esse é o tamanho do buffer de saída. Na saída, esse é o tamanho real do valor padrão definido pelo usuário. em ambos os casos, o tamanho é um inteiro sem sinal de 32 bits.

  • pvContext: um ponteiro para um buffer que contém os dados do usuário especificados na estrutura JET_USERDEFINEDDEFAULT quando a coluna foi criada ou NULL se nenhum contexto foi fornecido.

  • ulUnused: a ID da coluna para a qual o valor padrão definido pelo usuário está sendo recuperado.

Se um erro for retornado pelo retorno de chamada, a operação que originou o retorno de chamada falhará com esse erro.

Se JET_wrnBufferTruncated for retornado pelo retorno de chamada, a operação continuará, mas todo o valor não será recuperado durante o retorno de chamada.

Se JET_wrnColumnNull for retornado pelo retorno de chamada, a operação continuará, mas o valor padrão definido pelo usuário para a coluna será NULL.

JET_cbtypOnlineDefragCompleted
0x00000100

Esse retorno de chamada ocorrerá quando a desfragmentação online de um banco de dados, conforme iniciado pelo JetDefragment , tiver sido interrompida devido à conclusão do processo ou ao limite de tempo que está sendo atingido.

O ponteiro de função para esse motivo de retorno de chamada é passado para JetDefragment. Para obter mais informações, consulte JetDefragment.

Os parâmetros de retorno de chamada terão os seguintes valores:

  • sesid: a sessão usada para executar desfragmentação online para o banco de dados ou JET_sesidNil para um arquivo de streaming.

  • dbid: a ID do banco de dados que está sendo desfragmentado ou JET_dbidNil para um arquivo de streaming.

  • tableid: JET_tableidNil

  • pvArg1: NULL

  • pvArg2: NULL

  • pvContext: NULL

  • ulUnused: NULL

Se um erro for retornado pelo retorno de chamada, ele será ignorado.

JET_cbtypFreeCursorLS
0x00000200

Esse retorno de chamada ocorrerá quando o aplicativo precisar limpo o identificador de contexto do Armazenamento Local associado a um cursor que está sendo liberado pelo mecanismo de banco de dados. Para obter mais informações, consulte JetSetLS.

O ponteiro de função para esse motivo de retorno de chamada é configurado por meio de JetSetSystemParameter com JET_paramRuntimeCallback.

Os parâmetros de retorno de chamada terão os seguintes valores:

  • sesid: JET_sesidNil

  • dbid: JET_dbidNil

  • tableid: JET_tableidNil

  • pvArg1: o conjunto de identificadores de contexto usando JetSetLS

  • pvArg2: NULL

  • pvContext: NULL

  • ulUnused: NULL

Se um erro for retornado pelo retorno de chamada, ele será ignorado.

JET_cbtypFreeTableLS
0x00000400

Esse retorno de chamada ocorrerá como resultado da necessidade de o aplicativo limpar o identificador de contexto do Armazenamento Local associado a uma tabela que está sendo liberada pelo mecanismo de banco de dados. Para obter mais informações, consulte JetSetLS.

O ponteiro de função para esse motivo de retorno de chamada é configurado por meio de JetSetSystemParameter com JET_paramRuntimeCallback.

Os parâmetros de retorno de chamada terão os seguintes valores:

  • sesid: JET_sesidNil

  • dbid: JET_dbidNil

  • tableid: JET_tableidNil

  • pvArg1: o conjunto de identificadores de contexto usando JetSetLS.

  • pvArg2: NULL

  • pvContext: NULL

  • ulUnused: NULL

Se um erro for retornado pelo retorno de chamada, ele será ignorado.

Requisitos

Requisito Valor

Cliente

Requer o Windows Vista ou o Windows XP.

Servidor

Requer o Windows Server 2008 ou o Windows Server 2003.

Cabeçalho

Declarado em Esent.h.

Consulte Também

JET_CALLBACK