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


Функция 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 (include Wdm.h)
библиотеки Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

См. также

ClfsWriteRestartArea