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

  • Статья

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

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

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

    JET_ERR JET_API JET_PFNSTATUS(
                           JET_SESID  sesid,
                           JET_SNP snp,
                           JET_SNT snt,
                           void* pv
    );

Параметры

sesid

Сеанс типа JET_SESID , с помощью которого была вызвана долго выполняющаяся функция.

Snp

Тип операции, указанный в JET_SNP. Типы операций включают восстановление, сжатие, восстановление, резервное копирование, обновление, скраб и обновление формата записи.

Snt

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

Pv

Необязательный указатель на структуру типа JET_SNPROG.

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

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

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

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

Комментарии

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

Требования

Требование Значение

Клиент

Требуется Windows Vista, Windows XP или Windows 2000 Профессиональная.

Сервер

Требуется Windows Server 2008, Windows Server 2003 или Windows 2000 Server.

Верхняя часть

Объявлено в Esent.h.

См. также:

Коды ошибок расширяемого обработчика хранилища
Ошибки расширяемого обработчика хранилища
JET_SESID
JET_SNP
JET_SNPROG
JET_SNT