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

Функция ClfsAdvanceLogBase (wdm.h)

  • Статья

Подпрограмма ClfsAdvanceLogBase задает базовый номер LSN потока CLFS.

Синтаксис

CLFSUSER_API NTSTATUS ClfsAdvanceLogBase(
  [in, out] PVOID     pvMarshalContext,
  [in]      PCLFS_LSN plsnBase,
  [in]      ULONG     fFlags
);

Параметры

[in, out] pvMarshalContext

Указатель на непрозрачный контекст, представляющий область маршалинга, связанную с потоком CLFS. Вызывающий объект ранее получил этот указатель, вызвав ClfsCreateMarshallingArea.

[in] plsnBase

Указатель на структуру CLFS_LSN , содержащую новый базовый номер LSN. Этот параметр должен быть номером LSN одной из записей в потоке. Кроме того, этот параметр должен быть больше или равен текущему базовому номеру LSN потока и меньше или равен текущему последнему номеру LSN потока.

[in] fFlags

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

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

ClfsAdvanceLogBase возвращает STATUS_SUCCESS в случае успешного выполнения; в противном случае возвращается один из кодов ошибок, определенных в ntstatus.h.

Комментарии

ClfsAdvanceLogBase не записывает записи в журнал CLFS; только обновления журнала находятся в метаданных. Если вы хотите обновить базовый номер LSN и записать запись перезапуска в поток одновременно, вызовите ClfsWriteRestartArea.

По возможности CLFS избегает записи журналов, помещенных в очередь, которые имеют номера LSN меньше нового базового номера LSN, в стабильное хранилище.

ClfsAdvanceLogBase не проверка, чтобы узнать, является ли номер LSN, предоставленный в plsnBase, фактически LSN одной из записей в потоке. Если вызывающий объект задает для plsnBase значение LSN, которое не является номером LSN одной из записей в потоке, базовому номеру LSN потока будет присвоено бессмысленное значение.

Описание основных понятий и терминологии CLFS см. в разделе Common Log File System.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows Server 2003 R2, Windows Vista и более поздних версиях Windows.
Целевая платформа Персональный компьютер
Верхняя часть wdm.h (включая Wdm.h)
Библиотека Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

См. также раздел

ClfsWriteRestartArea