Функция JetOSSnapshotPrepare

Статья
12/06/2023

Область применения: Windows | Windows Server

Функция JetOSSnapshotPrepare

Функция JetOSSnapshotPrepare начинает подготовку сеанса моментального снимка. Сеанс моментального снимка — это короткий интервал времени, в котором подсистема не выдает никаких операций ввода-вывода на диск, чтобы модуль смог участвовать в сеансе моментального снимка тома (при использовании записи моментальных снимков).

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

    JET_ERR JET_API JetOSSnapshotPrepare(
      __out         JET_OSSNAPID* psnapId,
      __in          const JET_GRBIT grbit
    );

Параметры

psnapId

Идентификатор запускаемого сеанса моментального снимка.

гбит

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

Значение	Значение
0	Обычный моментальный снимок.
JET_bitIncrementalSnapshot	Будут приниматься только файлы журналов.
JET_bitCopySnapshot	Моментальный снимок копирования (обычный или добавочный) без усечения журнала.
JET_bitContinueAfterThaw	Сеанс моментального снимка происходит после jetOSSnapshotThaw и потребует вызова функции JetOSSnapshotEnd .
JET_bitExplicitPrepare	По умолчанию экземпляры не будут подготовлены. Windows 7: JET_bitExplicitPrepare представлена в Windows 7.

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

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

Код возврата	Description
JET_errSuccess	Операция успешно завершена.
JET_errInvalidParameter	Указатель идентификатора моментального снимка имеет значение NULL или параметр grbit недопустим.
JET_errOSSnapshotInvalidSequence	Сеанс моментального снимка уже выполняется, и операция не может иметь несколько сеансов моментальных снимков в любое время.

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

Запущенные экземпляры подсистемы теперь будут считаться частью сеанса моментального снимка.

Windows Vista: чтобы указать другое подмножество экземпляров, можно вызвать JetOSSnapshotPrepareInstance .

Обычный вызов последовательности API: JetOSSnapshotPrepare, а также один или несколько вызовов JetOSSnapshotPrepareInstance, а затем JetOSSnapshotFreeze. После запуска замораживания его можно завершить с помощью JetOSSnapshotThaw. В любое время после подготовки сеанс моментального снимка можно внезапно завершить с помощью JetOSSnapshotAbort.

Если JET_bitContinueAfterThaw указан после JetOSSnapshotThaw, сеанс моментального снимка останется (хотя ввод-вывод возобновляется). Это позволит проверить моментальный снимок и при необходимости включить усечение журнала с помощью JetOSSnapshotTruncateLog и потребует вызова JetOSSnapshotEnd.

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

Замечания

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

Requirements

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

См. также

JET_ERR
JET_OSSNAPID
JetOSSnapshotAbort
JetOSSnapshotEnd
JetOSSnapshotFreeze
JetOSSnapshotPrepareInstance
JetOSSnapshotThaw
JetOSSnapshotTruncateLog

Функция JetOSSnapshotPrepare