Função JetTruncateLog
Aplica-se a: Windows | Windows Server
Função JetTruncateLog
A função JetTruncateLog é usada durante um backup iniciado por JetBeginExternalBackup para excluir todos os arquivos de log de transações que não serão mais necessários quando o backup atual for concluído com êxito.
JET_ERR JET_API JetTruncateLog(void);
Parâmetros
Essa função não tem parâmetros.
Valor Retornado
Essa função retorna o tipo de dados JET_ERR com um dos seguintes códigos de retorno. Para obter mais informações sobre os possíveis erros de ESE, consulte Erros extensíveis do mecanismo de armazenamento e parâmetros de tratamento de erros.
Código de retorno |
Descrição |
|---|---|
JET_errSuccess |
A operação foi concluída com sucesso. |
JET_errBackupAbortByServer |
A operação falhou porque o backup externo atual foi anulado por uma chamada para JetStopBackup. Windows Server 2003: Esse valor retornado é introduzido no Windows Server 2003. |
JET_errClientRequestToStopJetService |
A operação não pode ser concluída porque todas as atividades na instância associada à sessão cessaram como resultado de uma chamada para JetStopService. |
JET_errInstanceUnavailable |
A operação não pode ser concluída porque a instância associada à sessão encontrou um erro fatal que exige que o acesso a todos os dados seja revogado para proteger a integridade desses dados. Windows XP: Esse valor retornado é introduzido no Windows XP. |
JET_errInvalidBackupSequence |
A operação de backup falhou porque foi chamada fora de sequência. JetTruncateLog retornará esse erro se houver identificadores de arquivo pendentes que foram criados usando JetOpenFile para a instância. |
JET_errInvalidParameter |
Um dos parâmetros fornecidos continha um valor inesperado ou a combinação de vários parâmetros gerava um resultado inesperado. Isso pode acontecer para JetTruncateLog quando o identificador de instância especificado é inválido. Windows XP: Esse valor retornado é introduzido no Windows XP. |
JET_errNoBackup |
A operação falhou porque nenhum backup externo está em andamento. |
JET_errNotInitialized |
A operação não pode ser concluída porque a instância associada à sessão ainda não foi inicializada. |
JET_errRestoreInProgress |
A operação não pode ser concluída porque uma operação de restauração está em andamento na instância associada à sessão. |
JET_errRunningInMultiInstanceMode |
A operação falhou porque foi feita uma tentativa de usar o mecanismo no modo herdado (modo de compatibilidade do Windows 2000) em que apenas uma instância tem suporte, quando na verdade várias instâncias já existem. |
JET_errTermInProgress |
A operação não pode ser concluída porque a instância associada à sessão está sendo desligada. |
Se essa função for bem-sucedida, o conjunto de arquivos de log de transações que não serão mais necessários depois que o backup atual for concluído com êxito será excluído. O computador de estado de backup será avançado de modo que o backup de arquivos de banco de dados não seja mais permitido. Somente arquivos de patch de banco de dados e arquivos de log de transações têm permissão para serem abertos para backup além desse ponto.
Se essa função falhar, o computador de estado de backup poderá ser avançado de modo que o backup de arquivos de banco de dados não seja mais permitido. Alguns arquivos de log de transações podem ser excluídos que é menor que o número desejado, mas eles sempre serão excluídos do mais antigo para o mais jovem.
Requisitos
| Requisito | Valor |
|---|---|
Cliente |
Requer Windows Vista, Windows XP ou Windows 2000 Professional. |
Servidor |
Requer o Windows Server 2008, o Windows Server 2003 ou o Windows 2000 Server. |
Cabeçalho |
Declarado em Esent.h. |
Biblioteca |
Use ESENT.lib. |
DLL |
Requer ESENT.dll. |
Consulte Também
Arquivos extensíveis do mecanismo de armazenamento
JetBeginExternalBackup
JET_ERR
JET_INSTANCE
JetOpenFile
JetStopBackup
JetStopService