Função JetEndExternalBackup

Aplica-se a: Windows | Windows Server

Função JetEndExternalBackup

A função JetEndExternalBackup encerra uma sessão de backup externo. Essa função é o último elemento de API em uma série de elementos de API que devem ser chamados para executar um backup online bem-sucedido (não baseado em VSS).

    JET_ERR JET_API JetEndExternalBackup(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 do 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_errNotInitialized	A operação não pode ser concluída porque a instância associada à sessão ainda não foi inicializada.
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_errTermInProgress	A operação não pode ser concluída porque a instância associada à sessão está sendo desligada.
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_errNoBackup	A operação falhou porque nenhum backup externo está em andamento.
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.
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 é 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_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.

Se essa 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, 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 apropriadas.

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

Parâmetros de tratamento de erros
Erros extensíveis do mecanismo de armazenamento
JetAttachDatabase
JetBeginExternalBackup
JetCloseFile
JET_ERR
JetExternalRestore
JetGetAttachInfo
JetGetLogInfo
JetOpenFile
JetReadFile
JetStopBackup
JetStopService
JetTruncateLog