Função de retorno de chamada JET_CALLBACK

Artigo
06/12/2023

Aplica-se a: Windows | Windows Server

Função de retorno de chamada JET_CALLBACK

A função JET_CALLBACK é uma função de retorno de chamada de várias finalidades usada pelo mecanismo de banco de dados para informar a aplicação de um evento que envolve desfragmentação online e notificações de estado do cursor.

Consulte JET_CBTYP para obter configurações específicas a serem usadas para os parâmetros dessa função, pois essas configurações serão diferentes dependendo da opção JET_CBTYP selecionada para uso no 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

A sessão para a qual o retorno de chamada está sendo feito.

dbid

O banco de dados para o qual o retorno de chamada está sendo feito.

Tableid

O cursor para o qual o retorno de chamada está sendo feito.

cbtyp

O ponto na operação em que o retorno de chamada está sendo feito. Consulte JET_CBTYP para obter uma lista de valores e o significado dos parâmetros a seguir em cada caso.

pvArg1

Um parâmetro usado para se comunicar com o aplicativo usando o retorno de chamada. Consulte JET_CBTYP para obter informações sobre o uso desse parâmetro para cada retorno de chamada com suporte pelo mecanismo de banco de dados.

pvArg2

pvContext

ulUnused

Valor Retornado

A função retorna um dos códigos de erro do Mecanismo de Armazenamento Extensível. Para obter informações sobre como retornar esses códigos como HRESULTs, consulte Erros extensíveis do mecanismo de armazenamento. Com êxito, a operação que emitiu o retorno de chamada pode continuar normalmente. Em alguns casos, o retorno de chamada pode retornar um aviso que influencia essa operação. Consulte JET_CBTYP para obter informações sobre o uso desses avisos pela operação.

Em caso de falha, a operação que emitiu o retorno de chamada pode continuar normalmente ou pode falhar. Consulte JET_CBTYP para obter informações sobre o uso do código de erro pela operação.

Comentários

Se o retorno de chamada passar um cursor para o aplicativo, é importante saber que esse cursor está intencionalmente limitado a um conjunto menor de funcionalidades para evitar a recursão e outras feiúras. As seguintes operações são permitidas:

Ao projetar o retorno de chamada, leve em conta que, mesmo com essas restrições, ainda é possível que o retorno de chamada falhe.

Requisitos

Requisito	Valor
Cliente	Requer Windows Vista, Windows XP ou Windows 2000 Professional.
Servidor	Requer o Windows Server 2008, o Windows Server 2003 ou o Windows 2000 Server.
Cabeçalho	Declarado em Esent.h.

Consulte Também

JET_API_PTR
JET_DBID
JET_SESID
JET_TABLEID
JET_CBTYP

Função de retorno de chamada JET_CALLBACK