Функция JetInit2

Статья
06/13/2023

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

Функция JetInit2

Функция JetInit2 переводит ядро СУБД в состояние, в котором оно может поддерживать использование приложениями файлов базы данных. Подсистема уже должна быть правильно настроена для инициализации с помощью JetSetSystemParameter. Аварийное восстановление базы данных выполняется автоматически в процессе инициализации.

Windows XP:JetInit2 представлена в Windows XP.

Эта функция является устаревшей. Вместо этого используйте JetInit3 .

JET_ERR JET_API JetInit2(
  __in_out_opt  JET_INSTANCE* pinstance,
  __in          JET_GRBIT grbit
);

Параметры

pinstance

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

В Windows 2000 этот параметр игнорируется и всегда должен иметь значение NULL.

В Windows XP и более поздних выпусках использование этого параметра зависит от режима работы подсистемы. Если подсистема работает в устаревшем режиме (режим совместимости Windows 2000), где поддерживается только один экземпляр, этот параметр может иметь значение NULL или задать допустимый выходной буфер, содержащий значение NULL, или JET_instanceNil который возвращает глобальный дескриптор экземпляра, созданный как побочный эффект инициализации. Затем этот дескриптор экземпляра можно передать в любой другой API, который принимает экземпляр. Если подсистема работает в режиме с несколькими экземплярами, для этого параметра необходимо задать допустимый входной буфер, содержащий дескриптор экземпляра, возвращаемый инициализируемым экземпляром JetCreateInstance .

grbit

Группа битов, задающая ноль или несколько следующих параметров.

Значение	Значение
JET_bitReplayReplicatedLogFiles	Зарезервировано для последующего использования.
JET_bitCreateSFSVolumeIfNotExist	Зарезервировано для последующего использования.
JET_bitReplayIgnoreMissingDB	Этот параметр позволяет пользователю выполнять восстановление в наборе файлов журнала без всех баз данных, которые были подключены в одной точке набора журналов.
JET_bitRecoveryWithoutUndo	Выполните восстановление, но остановите его на этапе Отмена. Это позволяет копировать и применять дополнительные журналы транзакций.
JET_bitTruncateLogsAfterRecovery	При успешном обратимом восстановлении усеките файлы журнала.
JET_bitReplayMissingMapEntryDB	Отсутствует запись карты базы данных по умолчанию в том же расположении.
JET_bitReplayIgnoreLostLogs	Игнорировать журналы, потерянные в конце потока журналов. Windows 7:JET_bitReplayIgnoreLostLogs представлена в Windows 7.

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

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

Экземпляр уничтожается вызовом функции JetTerm , даже если этот экземпляр никогда не инициализировался с помощью JetInit. Экземпляр — это единица восстановления для ядра СУБД. Он управляет жизненным циклом всех файлов, используемых для защиты целостности данных в наборе файлов базы данных. К этим файлам относятся файл контрольных точек и файлы журнала транзакций.

Если восстановление выполняется в наборе журналов, для которых присутствуют не все базы данных (которые возвращают ошибку JET_errAttachedDatabaseMismatch при обычных обстоятельствах), и клиент хочет продолжить восстановление, несмотря на отсутствие баз данных, JET_ bitReplayIgnoreMissingDB используется для продолжения восстановления доступных баз данных.

Дополнительные сведения см. в разделе Примечания в JetInit .

Требования

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

См. также:

Файлы расширяемого ядра хранилища
JET_ERR
JET_GRBIT
JET_INSTANCE
JetCreateInstance
JetInit
JetInit3
JetSetSystemParameter
Параметры ресурсов

Функция JetInit2