Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a: Windows | Windows Server
Função JetTruncateLogInstance
A função JetTruncateLogInstance é 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 depois que o backup atual for concluído com êxito.
Windows XP:JetTruncateLogInstance é introduzido no Windows XP.
JET_ERR JET_API JetTruncateLogInstance(
__in JET_INSTANCE instance
);
Parâmetros
instance
A instância a ser usada para essa chamada.
Para o Windows 2000, a variante de API que aceita esse parâmetro não está disponível porque há suporte apenas para uma instância. O uso dessa instância global está implícito nesse caso.
Para o Windows XP e versões posteriores, a variante da API que não aceita esse parâmetro só pode ser chamada quando o mecanismo está no modo herdado (modo de compatibilidade do Windows 2000) em que há suporte apenas para uma instância. Caso contrário, a operação falhará com JET_errRunningInMultiInstanceMode.
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 |
Windows Server 2003: Esse valor retornado é introduzido no Windows Server 2003. A operação falhou porque o backup externo atual foi anulado por uma chamada para JetStopBackup. |
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. Esse erro só será retornado pelo Windows XP e versões posteriores. |
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. |
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 o Windows Vista ou o Windows XP. |
Servidor |
Requer o Windows Server 2008 ou o Windows Server 2003. |
Cabeçalho |
Declarado em Esent.h. |
Biblioteca |
Use ESENT.lib. |
DLL |
Requer ESENT.dll. |
Consulte Também
Arquivos extensíveis do mecanismo de armazenamento
JET_ERR
JET_INSTANCE
JetBeginExternalBackup
JetOpenFile
JetStopBackup
JetStopService