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 de 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 (VERDADEIRO) ou lenta (FALSE).
Valor de retorno
ClfsRemoveLogContainerSet 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 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 |
|---|---|
| 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 |