Compartilhar via


Função SetLogArchiveTail (clfsw32.h)

Define o último LSN (número de sequência de log arquivado) ou a parte final do arquivo morto de um log arquivável.

Sintaxe

CLFSUSER_API BOOL SetLogArchiveTail(
  [in]                HANDLE    hLog,
  [in]                PCLFS_LSN plsnArchiveTail,
  [in, out, optional] LPVOID    pReserved
);

Parâmetros

[in] hLog

Um identificador para o log obtido de CreateLogFile.

O identificador de log pode se referir a um log dedicado ou multiplexado.

[in] plsnArchiveTail

Um ponteiro para uma estrutura CLFS_LSN que especifica um LSN físico válido no log.

Nota Para identificadores para um log físico ou um fluxo de log, plsnArchiveTail é um LSN físico, pois se refere a um endereço de registro no log físico.
 

[in, out, optional] pReserved

Esse parâmetro é reservado e deve ser definido 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

Se houver contextos de arquivo morto obtidos de PrepareLogArchive que não sejam encerrados com TerminateLogArchive, a alteração não terá efeito até que todos os arquivos sejam concluídos. Embora haja contextos de arquivos pendentes, somente a maior parte final do arquivo morto é aplicada.

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

CLFS_LSN

Funções comuns do sistema de arquivos de log

OVERLAPPED

RemoveLogContainer

RemoveLogContainerSet