Функция 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 |