Структура JET_LOGINFO

Статья
06/13/2023

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

Структура JET_LOGINFO

Структура JET_LOGINFO возвращает структурированные сведения о наборе файлов журнала транзакций, которые должны быть частью резервного набора файлов. Структура JET_LOGINFO — это минимальный набор данных, необходимый для представления диапазона журналов, извлекаемых с помощью JetGetLogInfoInstance2 или указанных для жесткого восстановления с помощью JetExternalRestore2.

typedef struct {
  unsigned long cbSize;
  unsigned long ulGenLow;
  unsigned long ulGenHigh;
  tchar szBaseName[JET_BASE_NAME_LENGTH + 1];
} JET_LOGINFO;

Элементы

cbSize

Размер структуры в байтах.

Этот элемент позволяет в будущем расширить эту структуру, одновременно обеспечивая обратную совместимость. Для него всегда должно быть задано значение sizeof( JET_LOGINFO ).

ulGenLow

Самый низкий (или самый старый) номер восстановленного файла журнала. Следует сохранить полную точность неподписанного long, но в текущих версиях подсистемы это число является шестнадцатеричным числом в диапазоне от 0x00000 до 0xFFFFF. В будущих версиях это может измениться.

ulGenHigh

Самый высокий (или самый последний) номер восстановленного файла журнала. Следует сохранить полную точность длинного без знака, но в текущих версиях подсистемы это число является шестнадцатеричным числом в диапазоне от 0x00000 до 0xFFFFF. В будущих версиях это может измениться.

szBaseName

Префикс, используемый для имен файлов журнала транзакций.

Значение, возвращаемое в этом элементе, всегда равно параметру JET_paramBaseName для экземпляра, создающего эти сведения.

Имена файлов журнала транзакций определяются в соответствии с базовым именем экземпляра и номером поколения файла журнала. Имя имеет формат BBBXXXXX. ЖУРНАЛА. BBB соответствует базовому имени файла журнала и всегда имеет длину в три символа. XXXXX соответствует номеру создания файла журнала в нулевом шестнадцатеричном формате и всегда имеет длину пять символов. LOG — это расширение файла, которое обработчик всегда предоставляет файлам журнала транзакций.

Использование этой структурированной информации не рекомендуется, так как это приводит к тому, что приложение имеет глубокие знания об этой схеме именования для файлов журнала транзакций. Если схема именования когда-либо изменится в будущем, такое приложение больше не будет работать должным образом. Вполне возможно, что формат журнала изменится на 8 шестнадцатеричных цифр в будущем. Вместо этого приложения должны использовать явный список имен файлов, возвращаемых JetGetLogInfo .

Требования

Требование	Значение
Клиент	Требуется Windows Vista или Windows XP.
Сервер	Требуется Windows Server 2008 или Windows Server 2003.
Верхняя часть	Объявлено в Esent.h.
Юникод	Реализовано как JET_LOGINFO_W (Юникод) и JET_LOGINFO_A (ANSI).

См. также:

JetExternalRestore2
JetGetLogInfo
JetGetLogInfoInstance2
Системные параметры

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

Структура JET_LOGINFO