Função ClfsCloseLogFileObject (wdm.h)

A rotina 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 lançadas. O chamador obteve esse ponteiro anteriormente chamando ClfsCreateLogFile.

Retornar valor

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

Comentários

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 caia 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

Confira também

ClfsCloseAndResetLogFile

ClfsCreateLogFile