Função ClfsAdvanceLogBase (wdm.h)
A rotina ClfsAdvanceLogBase define o LSN base de um fluxo CLFS.
Sintaxe
CLFSUSER_API NTSTATUS ClfsAdvanceLogBase(
[in, out] PVOID pvMarshalContext,
[in] PCLFS_LSN plsnBase,
[in] ULONG fFlags
);
Parâmetros
[in, out] pvMarshalContext
Um ponteiro para um contexto opaco que representa uma área de marshalling associada a um fluxo CLFS. O chamador obteve esse ponteiro anteriormente chamando ClfsCreateMarshallingArea.
[in] plsnBase
Um ponteiro para uma estrutura CLFS_LSN que contém o novo LSN base. Esse parâmetro deve ser o LSN de um dos registros no fluxo. Além disso, esse parâmetro deve ser maior ou igual ao LSN base atual do fluxo e menor ou igual ao LSN atual do fluxo.
[in] fFlags
Esse parâmetro é reservado para uso do sistema. Os chamadores devem definir esse parâmetro como zero.
Retornar valor
ClfsAdvanceLogBase retornará STATUS_SUCCESS se for bem-sucedido; caso contrário, retornará um dos códigos de erro definidos em Ntstatus.h.
Comentários
ClfsAdvanceLogBase não grava nenhum registro no log CLFS; as únicas atualizações para o log estão nos metadados. Se você quiser atualizar o LSN base e gravar um registro de reinicialização em um fluxo ao mesmo tempo, chame ClfsWriteRestartArea.
Sempre que possível, o CLFS evita gravar registros de log enfileirados que tenham LSNs menores que o novo LSN base no armazenamento estável.
ClfsAdvanceLogBase não marcar para ver se o LSN fornecido no plsnBase é, na verdade, o LSN de um dos registros no fluxo. Se o chamador definir plsnBase como um LSN que não seja o LSN de um dos registros no fluxo, o LSN base do fluxo será definido como um valor sem sentido.
Para obter uma explicação dos conceitos e terminologia do CLFS, consulte Common Log File System.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows Server 2003 R2, Windows Vista e versões posteriores do Windows. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | wdm.h (inclua Wdm.h) |
| Biblioteca | Clfs.lib |
| DLL | Clfs.sys |
| IRQL | <= APC_LEVEL |