Função ClfsDeleteLogFile (wdm.h)

A rotina ClfsDeleteLogFile marca um fluxo CLFS para exclusão.

Sintaxe

CLFSUSER_API NTSTATUS ClfsDeleteLogFile(
  [in]           PUNICODE_STRING puszLogFileName,
                 PVOID           pvReserved,
  [in]           ULONG           fLogOptionFlag,
  [in, optional] PVOID           pvContext,
  [in]           ULONG           cbContext
);

Parâmetros

[in] puszLogFileName

Um ponteiro para uma estrutura UNICODE_STRING que fornece o nome do fluxo CLFS a ser excluído.

Se o fluxo a ser excluído for o único fluxo de um log dedicado, o nome terá o nome do log de formulários:log físico, em que o nome do log físico é o nome do caminho do log físico no sistema de arquivos subjacente.

Se o fluxo a ser excluído for um dos fluxos de um log multiplexado, o nome terá o nome log:physical log::stream, em que o nome do log físico é o nome do caminho do log físico no sistema de arquivos subjacente e o nome do fluxo é o nome exclusivo do fluxo a ser excluído.

pvReserved

Reservado.

[in] fLogOptionFlag

Um valor que indica a relação entre CLFS e o componente que está excluindo o log. Para obter uma lista de valores possíveis, consulte a descrição do parâmetro fLogOptionFlag da rotina ClfsCreateLogFile .

[in, optional] pvContext

Um ponteiro para um contexto. A maneira como o contexto é interpretado depende do valor passado em fLogOptionFlag.

[in] cbContext

O tamanho, em bytes, do contexto apontado por pvContext. Se pvContext não for NULL, esse parâmetro deverá ser maior que zero.

Retornar valor

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

Comentários

O CLFS (Common Log File System) usa a estrutura LOG_FILE_OBJECT para representar logs. A função ClfsCreateLogFile retorna um ponteiro para LOG_FILE_OBJECT, que os clientes passam para outras funções CLFS.

Os clientes CLFS não acessam diretamente os membros de uma estrutura LOG_FILE_OBJECT. Para obter informações sobre os membros, consulte FILE_OBJECT.

ClfsDeleteLogFile marca um fluxo para exclusão, mas não fecha nenhum objeto de arquivo de log que esteja aberto no momento. Para fechar um objeto de arquivo de log, chame ClfsCloseLogFileObject. Um fluxo marcado para exclusão é excluído depois que todos os objetos de arquivo de log associados ao fluxo são fechados.

Um fluxo CLFS marcado para exclusão recusará solicitações subsequentes para abrir o fluxo.

O nome de um log CLFS físico não inclui a extensão .blf.

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

ClfsCloseLogFileObject

ClfsCreateLogFile

ClfsDeleteLogByPointer