Compartilhar via


Função DeleteLogByHandle (clfsw32.h)

Marca o log especificado para exclusão. Na verdade, o log é excluído quando todos os identificadores, áreas de marshaling e contextos de leitura para o log são fechados. Se o log for um log físico, seus contêineres subjacentes serão excluídos.

Quando um log é marcado para exclusão, as solicitações para abrir novos fluxos de log do cliente falham.

Nota Essa função difere de DeleteLogFile, pois ela usa um identificador aberto válido para o objeto de log em vez do nome do log.
 

Sintaxe

CLFSUSER_API BOOL DeleteLogByHandle(
  [in] HANDLE hLog
);

Parâmetros

[in] hLog

Um identificador para um log aberto obtido por uma chamada bem-sucedida para CreateLogFile. O log deve ter sido criado com acesso DELETE ou você não pode excluir o log.

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á 0 (zero). Para obter informações de erro estendidas, chame GetLastError. A lista a seguir identifica os possíveis códigos de erro:

Requisitos

Requisito Valor
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

Funções comuns do sistema de arquivos de log

CreateLogFile

DeleteLogFile