Função RemoveLogContainerSet (clfsw32.h)

Remove vários contêineres de um log associado a um identificador de log dedicado ou multiplexado.

Um cliente deve ter privilégios administrativos no identificador de log para remover um contêiner. A função RemoveLogContainer é um caso especial dessa função RemoveLogContainerSet , pois remove apenas um contêiner. Para remover vários contêineres, use RemoveLogContainerSet.

Sintaxe

CLFSUSER_API BOOL RemoveLogContainerSet(
  [in]                HANDLE hLog,
  [in]                USHORT cContainer,
  [in]                LPWSTR *rgwszContainerPath,
  [in]                BOOL   fForce,
  [in, out, optional] LPVOID pReserved
);

Parâmetros

[in] hLog

Um identificador para o log obtido de CreateLogFile.

O identificador de log deve ter permissão administrativa para adicionar um contêiner de log e pode se referir a um log dedicado ou multiplexado.

[in] cContainer

O número de nomes de caminho de contêiner em uma matriz apontada por rgwszContainerPath.

Esse valor deve ser diferente de zero.

[in] rgwszContainerPath

Uma matriz de ponteiros para nomes de caminho de contêiner que contêm ponteiros cContainers .

Cada nome de caminho é uma cadeia de caracteres larga que identifica um contêiner criado por AddLogContainer ou AddLogContainerSet.

[in] fForce

O sinalizador de exclusão que determina quando e como um contêiner é excluído.

Se fForce for TRUE e o contêiner fizer parte da região de log ativa, o contêiner não será excluído e um erro ERROR_LOG_CANT_DELETE será retornado.

Se FALSE, o contêiner será excluído quando o contêiner não fizer mais parte da região de log ativa.

[in, out, optional] pReserved

Reservado. Defina pReserved como NULL.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

A lista a seguir identifica os possíveis códigos de erro:

Comentários

Por padrão, a exclusão de contêiner é lenta, o que significa que um contêiner será excluído somente se ele não fizer parte do log ativo. Se o contêiner fizer parte do log ativo, ele será marcado para exclusão. Essa exclusão é adiada até que a parte final do log exceda o último setor do contêiner ou o contêiner tenha um identificador lógico maior que o identificador lógico do cabeçalho do log ativo. O tamanho do log reflete a exclusão do contêiner somente quando o contêiner é excluído fisicamente.

Um cliente de log pode solicitar uma exclusão forçada em um contêiner definindo o sinalizador de exclusão como TRUE. Isso tem o mesmo efeito que excluir um contêiner que não faz parte do log ativo. No entanto, se um contêiner fizer parte do log ativo, a chamada falhará sem marcar o contêiner para exclusão.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	clfsw32.h
Biblioteca	Clfsw32.lib
DLL	Clfsw32.dll

Confira também

AddLogContainer

AddLogContainerSet

Funções comuns do sistema de arquivos de log

OVERLAPPED

RemoveLogContainer