Função JetEndExternalBackupInstance
Aplica-se a: Windows | Windows Server
Função JetEndExternalBackupInstance
A função JetEndExternalBackupInstance encerra uma sessão de backup externo. Essa API é a última API em uma série de APIs que devem ser chamadas para executar um backup online bem-sucedido (não baseado em VSS).
Windows XP: JetEndExternalBackupInstance é introduzido no Windows XP.
JET_ERR JET_API JetEndExternalBackupInstance(
__in JET_INSTANCE instance
);
Parâmetros
instance
A instância a ser usada para essa chamada.
Windows 2000: 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.
Windows XP: 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_errBackupAbortByCaller |
Windows XP: Esse valor retornado é introduzido no Windows XP. O chamador encerrou um backup no meio da sequência de backup sem sinalizar a intenção com JetStopBackup. Esse erro é o resultado de um bug no cliente de backup no Windows Server 2003 e posterior. No Windows XP, esse erro é retornado para um encerramento intencional da sequência de backup externo. |
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 |
Windows XP: Esse valor retornado é introduzido no Windows XP. 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. |
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 a função for bem-sucedida, o backup externo foi um sucesso. Êxito indica que todos os arquivos (por exemplo, bancos de dados e logs) apropriados para o tipo de backup (especificado em JetBeginExternalBackup) foram recuperados do mecanismo de backup. Os arquivos de backup podem ser recuperados com recuperação rígida (JetExternalRestore).
Se essa função falhar, o backup externo geralmente terminará. Falha significa que o backup é inválido devido a um cliente ou um erro de uso do aplicativo. É importante marcar o código de retorno dessa API para verificar se a sequência de backup foi bem-sucedida.
Comentários
Se o mecanismo estiver configurado para registrar eventos em log, um evento será registrado para indicar a resolução do backup externo.
Se a sequência de backup não for concluída em ordem e com uma chamada bem-sucedida para JetEndExternalBackup, os backups incrementais subsequentes poderão conter mais dados do que o aplicativo previa.
Para obter mais informações sobre a sequência de API de backup externo, consulte JetBeginExternalBackup.
Antes do Windows Vista, se o truncamento de log não foi feito, o mecanismo considerou que o backup era um backup de cópia. No entanto, o backup pode ser um backup normal para o qual o truncamento não foi feito (por exemplo, se houver bancos de dados desanexados). A opção JET_bitBackupTruncateDone pode ser usada para informar o mecanismo sobre isso e permitir modificações de cabeçalho de banco de dados adequadas.
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
Parâmetros de tratamento de erro
Erros extensíveis do mecanismo de armazenamento
JetAttachDatabase
JetBeginExternalBackup
JetBeginExternalBackupInstance
JetCloseFile
JET_ERR
JetExternalRestore
JetGetAttachInfo
JetGetLogInfo
JET_INSTANCE
JetOpenFile
JetReadFile
JetStopBackup
JetStopService
JetTruncateLog