Функция JetIdle

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

Функция JetIdle

Функция JetIdle не существует и должна использоваться только в целях тестирования. JetIdle можно использовать для выполнения задач очистки бездействия или проверка состояния хранилища версий в ESE.

    JET_ERR JET_API JetIdle(
      __in          JET_SESID sesid,
      __in          JET_GRBIT grbit
    );

Параметры

sesid

Сеанс, который будет использоваться для этого вызова.

grbit

Группа битов, содержащая параметры, используемые для этого вызова, которые включают ноль или более из следующих битов:

Значение	Значение
JET_bitIdleCompact	Запускает очистку хранилища версий.
JET_bitIdleFlushBuffers	Зарезервировано для последующего использования. Если этот флаг указан, API вернет JET_errInvalidgrbit.
JET_bitIdleStatus	Возвращает JET_wrnIdleFull, если хранилище версий заполнено более чем наполовину.

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

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

Код возврата	Описание
JET_errSuccess	Операция выполнена успешно.
JET_errInvalidParameter	Недопустимый параметр grbit , предоставленный API.

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

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

Комментарии

Хранилище версий поддерживает механизм изоляции snapshot ESE. Если хранилище версий заполнено более чем наполовину, программа может закрыть длительные транзакции. Если долго выполняющаяся транзакция исчерпывает хранилище версий, ESE перестанет разрешать операции записи в базу данных.

Требования

Требование	Значение
Клиент	Требуется Windows Vista, Windows XP или Windows 2000 Professional.
Сервер	Требуется Windows Server 2008, Windows Server 2003 или Windows 2000 Server.
Верхняя часть	Объявлено в Esent.h.
Библиотека	Используйте ESENT.lib.
DLL	Требуется ESENT.dll.

См. также:

JET_ERR
JET_GRBIT
JET_SESID
JetCommitTransaction