Função ClfsRemoveLogContainer (wdm.h)
A rotina ClfsRemoveLogContainer remove um contêiner de um log CLFS.
Sintaxe
CLFSUSER_API NTSTATUS ClfsRemoveLogContainer(
[in] PLOG_FILE_OBJECT plfoLog,
[in] PUNICODE_STRING puszContainerPath,
[in] BOOLEAN fForce
);
Parâmetros
[in] plfoLog
Um ponteiro para uma estrutura LOG_FILE_OBJECT que representa um log CLFS do qual o contêiner será removido. O chamador obteve esse ponteiro anteriormente chamando ClfsCreateLogFile.
[in] puszContainerPath
Um ponteiro para uma estrutura UNICODE_STRING que fornece o nome do caminho para o contêiner a ser removido. O nome do caminho foi criado em uma chamada anterior para ClfsAddLogContainer ou ClfsAddLogContainerSet. O caminho pode ser absoluto ou relativo ao local do arquivo de log base para o log CLFS representado por plfoLog. Os caminhos relativos ao arquivo de log base devem começar com CLFS_CONTAINER_RELATIVE_PREFIX, que é o literal da cadeia de caracteres (L"%BLF%\"). Os diretórios "." e "." não são permitidos em um caminho relativo.
[in] fForce
Um valor booliano que especifica se a remoção do contêiner é forçada (TRUE) ou lenta (FALSE).
Retornar valor
ClfsRemoveLogContainer retornará STATUS_SUCCESS se for bem-sucedido; caso contrário, retornará um dos códigos de erro definidos em Ntstatus.h.
Comentários
A remoção forçada de contêiner (fForce = TRUE) só terá êxito se o contêiner a ser removido não fizer parte do log ativo.
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 |