Função ClfsCloseAndResetLogFile (wdm.h)
O ClfsCloseAndResetLogFile libera todas as referências a um objeto de arquivo de log especificado e marca seu fluxo associado para redefinição.
CLFSUSER_API NTSTATUS ClfsCloseAndResetLogFile(
[in] PLOG_FILE_OBJECT plfoLog
);
[in] plfoLog
Um ponteiro para uma estrutura de LOG_FILE_OBJECT para a qual as referências serão liberadas. O chamador obteve esse ponteiro anteriormente chamando ClfsCreateLogFile.
ClfsCloseAndResetLogFile retornará STATUS_SUCCESS se tiver êxito; caso contrário, ele retorna um dos códigos de erro definidos em Ntstatus.h.
ClfsCloseAndResetLogFile libera todas as referências, adquiridas pelo CLFS, para o objeto de arquivo de log especificado. Normalmente, o cliente não terá adquirido nenhuma referência adicional ao objeto de arquivo de log. No entanto, se o cliente obteve referências adicionais, é responsabilidade do cliente liberá-las.
ClfsCloseAndResetLogFile faz com que a contagem de referência do objeto de arquivo de log especificado seja suspensa para zero, momento em que o objeto de arquivo de log é fechado (ou seja, sua memória é desalocada). O fluxo representado pelo objeto de arquivo de log pode não ser redefinido, no entanto, porque pode haver outros objetos de arquivo de log que representam o mesmo fluxo. O fluxo é redefinido depois que todos os objetos de arquivo de log que representam o fluxo são fechados (por exemplo, chamadas para ClfsCloseLogFileObject).
Um fluxo de redefinição é como um fluxo recém-criado que nunca teve nenhum registro gravado nele.
Ao retornar dessa rotina, plfoLog é inválido.
Você pode chamar ClfsCloseAndResetLogFile no máximo 124 vezes para um determinado fluxo.
Para obter uma explicação dos conceitos e terminologia do CLFS, consulte Common Log File System.
| 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 |