Función ClfsAdvanceLogBase (wdm.h)

La rutina ClfsAdvanceLogBase establece el LSN base de una secuencia CLFS.

Sintaxis

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

Parámetros

[in, out] pvMarshalContext

Puntero a un contexto opaco que representa un área de serialización asociada a una secuencia CLFS. El autor de la llamada obtuvo previamente este puntero llamando a ClfsCreateMarshallingArea.

[in] plsnBase

Puntero a una estructura de CLFS_LSN que contiene el nuevo LSN base. Este parámetro debe ser el LSN de uno de los registros de la secuencia. Además, este parámetro debe ser mayor o igual que el LSN base actual de la secuencia y menor o igual que el último LSN actual de la secuencia.

[in] fFlags

Este parámetro está reservado para uso del sistema. Los autores de llamadas deben establecer este parámetro en cero.

Valor devuelto

ClfsAdvanceLogBase devuelve STATUS_SUCCESS si se realiza correctamente; de lo contrario, devuelve uno de los códigos de error definidos en Ntstatus.h.

Comentarios

ClfsAdvanceLogBase no escribe ningún registro en el registro CLFS; las únicas actualizaciones del registro están en los metadatos. Si desea actualizar el LSN base y escribir un registro de reinicio en una secuencia al mismo tiempo, llame a ClfsWriteRestartArea.

Siempre que sea posible, CLFS evita escribir registros de registro en cola que tengan LSN menos que el nuevo LSN base en el almacenamiento estable.

ClfsAdvanceLogBase no comprueba si el LSN proporcionado en plsnBase es realmente el LSN de uno de los registros de la secuencia. Si el autor de la llamada establece plsnBase en un LSN que no es el LSN de uno de los registros de la secuencia, el LSN base de la secuencia se establecerá en un valor sin sentido.

Para obtener una explicación de los conceptos y la terminología de CLFS, consulte Common Log File System.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Server 2003 R2, Windows Vista y versiones posteriores de Windows.
Plataforma de destino	Escritorio
Encabezado	wdm.h (incluya Wdm.h)
Library	Clfs.lib
Archivo DLL	Clfs.sys
IRQL	<= APC_LEVEL

Consulte también

ClfsWriteRestartArea