Función ClfsAdvanceLogBase (wdm.h)
La rutina ClfsAdvanceLogBase establece el LSN base de un flujo 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 anteriormente este puntero llamando a ClfsCreateMarshallingArea.
[in] plsnBase
Puntero a una estructura 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 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 ejecuta correctamente; de lo contrario, devuelve uno de los códigos de error definidos en Ntstatus.h.
Observaciones
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 | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Server 2003 R2, Windows Vista y versiones posteriores de Windows. |
| de la plataforma de destino de | Escritorio |
| encabezado de | wdm.h (incluya Wdm.h) |
| biblioteca de | Clfs.lib |
| DLL de | Clfs.sys |
| irQL | <= APC_LEVEL |