Функция JetStopService

  • Статья

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

Функция JetStopService

Функция JetStopService подготавливает экземпляр к завершению.

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

    JET_ERR JET_API JetStopService(void);

Параметры

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

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

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

Код возврата

Описание

JET_errSuccess

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

JET_errRunningInMultiInstanceMode

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

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

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

  • Остановите дефрагментацию в сети, если она запущена.

  • Запустите очистку хранилища версий.

  • Уменьшите глубину контрольной точки, начав очистку грязное страниц в диспетчере буферов.

  • Предотвращение будущих вызовов большинства функций для этого экземпляра.

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

Комментарии

Эта функция сокращает работу, которые придется выполнить экземпляру при завершении работы, но не завершает работу экземпляра. В результате эта функция является просто оптимизацией и не является обязательной для использования. Обратите внимание, что объем подготовительных работ в Windows 2000 и Windows XP был меньше. После успешного выполнения функции вызов функций, которые больше не разрешены, вернет JET_errClientRequestToStopJetService. Функции, которые по-прежнему разрешены после этого вызова: JetRollback, JetCloseTable, JetEndSession, JetCloseDatabase, JetDetachDatabase и JetResetSessionContext.

Требования

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

Клиент

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

Сервер

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

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

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

Библиотека

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

DLL

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

См. также:

JET_ERR
JET_INSTANCE
JetCloseDatabase
JetCloseTable
JetDetachDatabase
JetEndSession
JetResetSessionContext
JetRollback
JetTerm
JetTerm2