Função ClfsCloseAndResetLogFile (wdm.h)

  • Artigo

A rotina ClfsCloseAndResetLogFile libera todas as referências a um objeto de arquivo de log especificado e marca seu fluxo associado para redefinição.

Sintaxe

CLFSUSER_API NTSTATUS ClfsCloseAndResetLogFile(
  [in] PLOG_FILE_OBJECT plfoLog
);

Parâmetros

[in] plfoLog

Um ponteiro para uma estrutura LOG_FILE_OBJECT para a qual as referências serão lançadas. O chamador obteve esse ponteiro anteriormente chamando ClfsCreateLogFile.

Retornar valor

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

Comentários

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

ClfsCloseAndResetLogFile 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 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.

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

ClfsCloseLogFileObject

ClfsDeleteLogByPointer

ClfsDeleteLogFile