Função ClfsCloseLogFileObject (wdm.h)
O ClfsCloseLogFileObject libera todas as referências a um objeto de arquivo de log.
Sintaxe
CLFSUSER_API NTSTATUS ClfsCloseLogFileObject(
[in] PLOG_FILE_OBJECT plfoLog
);
Parâmetros
[in] plfoLog
Um ponteiro para a estrutura LOG_FILE_OBJECT para a qual as referências serão liberadas. O chamador obteve esse ponteiro anteriormente chamando ClfsCreateLogFile.
Valor de retorno
ClfsCloseLogFileObject retornará STATUS_SUCCESS se tiver êxito; caso contrário, ele retorna um dos códigos de erro definidos em Ntstatus.h.
Observações
ClfsCloseLogFileObject 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.
ClfsCloseLogFileObject 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 permanecer aberto, no entanto, porque pode haver outros objetos de arquivo de log que representam o mesmo fluxo. O fluxo é fechado depois que todos os objetos de arquivo de log que representam o fluxo são fechados.
Ao retornar dessa rotina, plfoLog é inválido.
Para obter uma explicação dos conceitos e terminologia do CLFS, consulte Common Log File System.
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 |