Função ClfsCloseLogFileObject (wdm.h)

  • Artigo

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 tiver obtido referências adicionais, será responsabilidade do cliente liberá-los.

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

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

Confira também

ClfsCloseAndResetLogFile

ClfsCreateLogFile