Função ClfsSetEndOfLog (wdm.h)
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.
Valor de retorno
ClfsSetEndOfLog retornará STATUS_SUCCESS se tiver êxito; caso contrário, ele retorna um dos códigos de erro definidos em Ntstatus.h.
Observações
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 por 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 de modo kernel ClfsSetEndOfLog é reservada para uso futuro e, atualmente, sempre retorna STATUS_NOT_SUPPORTED. No entanto, a rotina de modo de usuário SetEndOfLog atualmente tem suporte.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Server 2003 R2, Windows Vista e versões posteriores do Windows. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | wdm.h (inclua Wdm.h) |
| biblioteca | Clfs.lib |
| de DLL | Clfs.sys |
| IRQL | <= APC_LEVEL |