Função ClfsRemoveLogContainer (wdm.h)
A rotina de 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 de 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 (VERDADEIRO) ou lenta (FALSE).
Valor de retorno
ClfsRemoveLogContainer retornará STATUS_SUCCESS se tiver êxito; caso contrário, ele retorna um dos códigos de erro definidos em Ntstatus.h.
Observações
A remoção forçada do 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 |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Server 2003 R2, Windows Vista e versões posteriores do Windows. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | wdm.h (inclua Wdm.h) |
| biblioteca | Clfs.lib |
| de DLL | Clfs.sys |
| IRQL | <= APC_LEVEL |