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

Функция JetStopServiceInstance

  • Статья

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

Функция JetStopServiceInstance

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

Windows XP:JetStopServiceInstance появилась в Windows XP.

    JET_ERR JET_API JetStopServiceInstance(
      __in          JET_INSTANCE instance
    );

Параметры

Экземпляр

Запущенный экземпляр, используемый для вызова API.

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

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

Код возврата

Описание

JET_errSuccess

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

JET_errInvalidParameter

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

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

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

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

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

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

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

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

Комментарии

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

Требования

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

Клиент

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

Сервер

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

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

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

Библиотека

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

DLL

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

См. также:

JET_ERR
JET_INSTANCE
JetCloseDatabase
JetCloseTable
JetDetachDatabase
JetEndSession
JetResetSessionContext
JetRollback
JetTerm
JetTerm2