Функция JetOSSnapshotTruncateLog

Статья
06/13/2023

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

Функция JetOSSnapshotTruncateLog

Функция JetOSSnapshotTruncateLog обеспечивает усечение журнала для всех экземпляров, которые являются частью snapshot сеанса.

Windows Vista:JetOSSnapshotTruncateLog представлена в Windows Vista.

    JET_ERR JET_API JetOSSnapshotTruncateLog(
      __in          const JET_OSSNAPID snapId,
      __in          const JET_GRBIT grbit
    );

Параметры

snapId

Идентификатор сеанса snapshot.

grbit

Параметры для этого вызова. Этот параметр может иметь сочетание следующих значений.

Значение	Значение
JET_bitAllDatabasesSnapshot	Все базы данных подключены, поэтому подсистема хранилища может выполнять вычисления и усечение журнала.
0 (ноль)	Усечение не будет происходить.

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

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

Код возврата	Описание
JET_errSuccess	Операция выполнена успешно.
JET_errInvalidGrbit	Недопустимый параметр grbit .
JET_errOSSnapshotInvalidSequence	Сеанс snapshot не находится в состоянии, в котором может произойти усечение. Возможные причины. вызов выполняется после истечения времени ожидания сеанса snapshot сеанс был указан в качестве копии snapshot

Код возврата

Описание

JET_errSuccess

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

JET_errInvalidGrbit

Недопустимый параметр grbit .

JET_errOSSnapshotInvalidSequence

Сеанс snapshot не находится в состоянии, в котором может произойти усечение. Возможные причины.

вызов выполняется после истечения времени ожидания сеанса snapshot
сеанс был указан в качестве копии snapshot

При успешном выполнении файлы журнала для одного или всех экземпляров snapshot сеанса будут по возможности усечены.

Эта функция должна вызываться только в том случае, если snapshot была создана с параметром JET_bitContinueAfterThaw. В противном случае сеанс snapshot завершился бы после вызова JetOSSnapshotThaw.

Требования

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

См. также:

Параметры обработки ошибок
Ошибки расширяемого обработчика хранилища
JET_ERR
JetOSSnapshotEnd
JetOSSnapshotFreeze
JetOSSnapshotPrepare
JetOSSnapshotThaw

Share via

Функция JetOSSnapshotTruncateLog