Функция обратного вызова JET_CALLBACK

Статья
06/13/2023

Применимо к: Windows | Windows Server

Функция обратного вызова JET_CALLBACK

Функция JET_CALLBACK — это многоцелевая функция обратного вызова, используемая ядром СУБД для информирования приложения о событии, связанном с дефрагментацией в сети и уведомлениями о состоянии курсора.

Конкретные параметры, используемые для параметров функции, см. в JET_CBTYP , так как эти параметры будут отличаться в зависимости от параметра JET_CBTYP , выбранного для использования в параметре 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
    );

Параметры

sesid

Сеанс, для которого выполняется обратный вызов.

dbid

База данных, для которой выполняется обратный вызов.

tableid

Курсор, для которого выполняется обратный вызов.

cbtyp

Точка в операции, в которой выполняется обратный вызов. Список значений и значение следующих параметров в каждом случае см. в JET_CBTYP .

pvArg1

Параметр, используемый для взаимодействия с приложением с помощью обратного вызова. Сведения об использовании этого параметра для каждого обратного вызова, поддерживаемого ядром СУБД, см. в JET_CBTYP .

pvArg2

pvContext

ulUnused

Возвращаемое значение

Функция возвращает один из кодов ошибок расширяемого модуля хранения данных. Сведения о том, как возвращать эти коды в виде HRESULT, см. в разделе Ошибки расширяемого обработчика хранилища. При успешном выполнении операции, которая выполнила обратный вызов, может продолжаться в обычном режиме. В некоторых случаях обратный вызов может возвращать предупреждение, влияющее на операцию. Сведения об использовании этих предупреждений операцией см. в JET_CBTYP .

При сбое операция, которая выдала обратный вызов, может продолжаться обычным образом или может завершиться сбоем. Сведения об использовании кода ошибки операцией см. в JET_CBTYP .

Если обратный вызов передает курсор в приложение, важно знать, что этот курсор намеренно ограничен небольшим набором функциональных возможностей, чтобы избежать рекурсии и других уродства. Разрешены следующие операции:

При проектировании обратного вызова учитывайте, что даже с этими ограничениями обратный вызов по-прежнему может завершиться ошибкой.

Требования

Требование	Значение
Клиент	Требуется Windows Vista, Windows XP или Windows 2000 Professional.
Сервер	Требуется Windows Server 2008, Windows Server 2003 или Windows 2000 Server.
Верхняя часть	Объявлено в Esent.h.

См. также:

JET_API_PTR
JET_DBID
JET_SESID
JET_TABLEID
JET_CBTYP

Функция обратного вызова JET_CALLBACK