Поделиться через

Функция JetStopBackupInstance

  • Статья

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

Функция JetStopBackupInstance

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

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

    JET_ERR JET_API JetStopBackupInstance(
      __in          JET_INSTANCE instance
    );

Параметры

Экземпляр

Идентифицирует работающий экземпляр, используемый для вызова API.

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

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

Код возврата

Описание

JET_errSuccess

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

JET_errInvalidParameter

Указанный параметр экземпляра имеет недопустимое значение (не экземпляр, который выполняется в данный момент).

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

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

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

Комментарии

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

Требования

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

Клиент

Требуется Windows Vista или Windows XP.

Сервер

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

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

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

Библиотека

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

DLL

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

См. также:

JET_ERR
JET_INSTANCE
JetEndExternalBackupInstance
JetReadFileInstance
JetStopService