Função ClfsSetEndOfLog (wdm.h)

Artigo
02/27/2024

A rotina ClfsSetEndOfLog trunca um fluxo CLFS.

Sintaxe

CLFSUSER_API NTSTATUS ClfsSetEndOfLog(
  [in] PLOG_FILE_OBJECT plfoLog,
  [in] PCLFS_LSN        plsnEnd
);

Parâmetros

[in] plfoLog

Um ponteiro para uma estrutura LOG_FILE_OBJECT que representa um fluxo CLFS. Esse fluxo deve ser o único fluxo de um log dedicado. O chamador obteve esse ponteiro anteriormente chamando ClfsCreateLogFile.

[in] plsnEnd

Um ponteiro para uma estrutura CLFS_LSN que fornece o LSN do registro que deve se tornar o último registro do fluxo. Esse deve ser o LSN exato de um dos registros no fluxo.

Retornar valor

ClfsSetEndOfLog retornará STATUS_SUCCESS se for bem-sucedido; caso contrário, retornará um dos códigos de erro definidos em Ntstatus.h.

Comentários

O LSN fornecido no valor plsnEnd não é validado. É responsabilidade do chamador fornecer um LSN válido; ou seja, um que é o LSN exato de um registro no fluxo.

Esse fluxo representado pelo plfoLog deve ser de um log dedicado. Essa rotina não dá suporte a fluxos de logs multiplexados.

Para obter uma explicação dos conceitos e terminologia do CLFS, consulte Common Log File System.

A rotina do modo kernel ClfsSetEndOfLog é reservada para uso futuro e atualmente sempre retorna STATUS_NOT_SUPPORTED. No entanto, atualmente, há suporte para a rotina de modo de usuário SetEndOfLog .

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