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 |