Функция JetUnregisterCallback

Статья
06/13/2023

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

Функция JetUnregisterCallback

Функция JetUnregisterCallback позволяет приложению настроить ядро СУБД для прекращения отправки уведомлений приложению, как это было запрошено ранее с помощью JetRegisterCallback.

Windows XP:JetUnregisterCallback представлена в Windows XP.

    JET_ERR JET_API JetUnregisterCallback(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          JET_CBTYP cbtyp,
      __in          JET_HANDLE hCallbackId
    );

Параметры

sesid

Сеанс, используемый для этого вызова.

tableid

Курсор, используемый для этого вызова.

cbtyp

Битовая маска, состоящая из причин обратного вызова, по которым приложение больше не хочет получать уведомления.

Чтобы создать эту битовую маску, просто или вместе допустимые причины обратного вызова из перечисления JET_CBTYP .

hCallbackId

Дескриптор зарегистрированного обратного вызова, возвращенного JetRegisterCallback.

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

Эта функция возвращает тип данных JET_ERR с одним из следующих кодов возврата. Дополнительные сведения о возможных ошибках ESE см. в разделах Ошибки подсистемы расширяемого хранилища и Параметры обработки ошибок.

Код возврата	Описание
JET_errSuccess	Операция выполнена успешно.
JET_errClientRequestToStopJetService	Операция не может завершиться, так как все действия на экземпляре, связанном с сеансом, прекратились в результате вызова JetStopService.
JET_errInstanceUnavailable	Операция не может завершиться, так как экземпляр, связанный с сеансом, столкнулся с неустранимой ошибкой, требующей отмены доступа ко всем данным для защиты целостности этих данных. Windows XP: Это возвращаемое значение появилось в Windows XP.
JET_errNotInitialized	Операция не может завершиться, так как экземпляр, связанный с сеансом, еще не инициализирован.
JET_errRestoreInProgress	Операция не может завершиться, так как выполняется операция восстановления на экземпляре, связанном с сеансом.
JET_errSessionSharingViolation	Один и тот же сеанс нельзя использовать одновременно для нескольких потоков. Windows XP: Это возвращаемое значение появилось в Windows XP.
JET_errTermInProgress	Операция не может завершиться, так как экземпляр, связанный с сеансом, завершает работу.

Если эта функция выполняется успешно, указанный обратный вызов будет отменен по заданным причинам обратного вызова в таблице, связанной с заданным курсором. Изменение состояния базы данных не произойдет.

Если эта функция завершается сбоем, указанный обратный вызов не будет отменен. Изменение состояния базы данных не произойдет.

Указанная битовая маска должна точно соответствовать битовой маске, указанной при регистрации обратного вызова. Ядро СУБД в настоящее время не поддерживает удаление подмножества этих уведомлений и не возвращает ошибку при попытке.

Требования

Требование	Значение
Клиент	Требуется Windows Vista или Windows XP.
Сервер	Требуется Windows Server 2008 или Windows Server 2003.
Верхняя часть	Объявлено в Esent.h.
Библиотека	Используйте ESENT.lib.
DLL	Требуется ESENT.dll.

См. также:

JET_CBTYP
JET_ERR
JET_HANDLE
JET_SESID
JET_TABLEID
JetRegisterCallback
JetStopService

Функция JetUnregisterCallback