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