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 |