Função ClfsRemoveLogContainer (wdm.h)

Artigo
02/27/2024

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