Share via

Функция JetStopBackup

  • Статья

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

Функция JetStopBackup

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

Windows XP: Эта функция появилась в Windows XP.

JetStopService — это устаревший вызов, если разрешен только один экземпляр. В этом случае единственным активным экземпляром является тот, который готовится к завершению.

JET_ERR JET_API JetStopBackup(void);

Параметры

У этой функции нет параметров.

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

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

Код возврата

Описание

JET_errSuccess

Операция выполнена успешно.

JET_errRunningInMultiInstanceMode

Неясно, какой экземпляр следует подготовить к завершению при использовании JetStopService с режимом нескольких экземпляров.

Windows XP: Это возвращаемое значение появилось в Windows XP.

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

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

Комментарии

Резервное копирование обычно активируется событием вне механизма процесса, и с помощью этого API само приложение ESENT будет выполнять любые дальнейшие вызовы к API потоковой архивации для сбоя. Большинство API потокового резервного копирования начнут завершаться сбоем с JET_errBackupAbortByServer. Таким образом, любой ход выполнения резервного копирования потоковой передачи (например , JetReadFileInstance) вернет ошибку. Операции резервного копирования, которые являются частью завершения резервного копирования (например , JetEndExternalBackupInstance), по-прежнему будут разрешены.

Требования

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

Клиент

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

Сервер

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

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

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

Библиотека

Используйте ESENT.lib.

DLL

Требуется ESENT.dll.

См. также:

JetEndExternalBackupInstance
JET_ERR
JET_INSTANCE
JetReadFileInstance
JetStopService