Функция 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