Функция JetStopBackupInstance

Статья
06/13/2023

Применимо к: 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.

Код возврата

Описание

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

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

Функция JetStopBackupInstance