Função ClfsRemoveLogContainerSet (wdm.h)

A rotina ClfsRemoveLogContainerSet remove atomicamente um conjunto de contêineres de um log CLFS.

Sintaxe

CLFSUSER_API NTSTATUS ClfsRemoveLogContainerSet(
  [in] PLOG_FILE_OBJECT plfoLog,
  [in] USHORT           cContainers,
  [in] PUNICODE_STRING  rgwszContainerPath,
  [in] BOOLEAN          fForce
);

Parâmetros

[in] plfoLog

Um ponteiro para uma estrutura LOG_FILE_OBJECT que representa o log CLFS do qual os contêineres serão removidos. O chamador obteve esse ponteiro anteriormente chamando ClfsCreateLogFile.

[in] cContainers

O número de contêineres no conjunto. Esse é o número de elementos na matriz rgwszContainerPath .

[in] rgwszContainerPath

Um ponteiro para uma matriz de estruturas de UNICODE_STRING , cada uma das quais fornece o nome do caminho para um dos contêineres a serem removidos. O número de elementos na matriz é fornecido por cContainers. Um determinado 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

ClfsRemoveLogContainerSet 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 os contêineres a serem removidos não fizerem 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

Confira também

ClfsAddLogContainerSet

ClfsCreateLogFile

ClfsRemoveLogContainer

LOG_FILE_OBJECT

UNICODE_STRING