Compartilhar via

Função JetBeginExternalBackupInstance

  • Artigo

Aplica-se a: Windows | Windows Server

Função JetBeginExternalBackupInstance

A função JetBeginExternalBackupInstance inicia um backup externo enquanto o mecanismo e o banco de dados estão online e ativos.

Windows XP: JetBeginExternalBackupInstance é introduzido no Windows XP.

    JET_ERR JET_API JetBeginExternalBackupInstance(
      __in          JET_INSTANCE instance,
      __in          JET_GRBIT grbit
    );

Parâmetros

instance

A instância de banco de dados 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.

grbit

Um grupo de bits que especifica zero ou mais das opções a seguir.

Valor

Significado

JET_bitBackupAtomic

Esse sinalizador foi preterido. O uso desse bit resultará no retorno de JET_errInvalidgrbit.

JET_bitBackupIncremental

Cria um backup incremental em vez de um backup completo. Isso significa que somente os arquivos de log desde o último backup completo ou incremental serão copiados em backup.

JET_bitBackupSnapshot

Reservado para uso futuro. Definido para Windows XP.

Valor Retornado

O sistema pode gerar códigos de êxito ou falha como resultado de uma chamada para essa função. Para obter uma lista completa de erros para essa API, consulte Códigos de erro extensíveis do mecanismo de armazenamento.

Consulte JetBeginExternalBackup.

Comentários

JetBeginExternalBackupInstance é a primeira função em uma série de funções que devem ser chamadas para executar um backup online bem-sucedido (não baseado em VSS). Consulte também JetBeginExternalBackup e JetStopBackupInstance.

Um backup externo pode ser usado para implementar backups completos, incrementais ou diferenciais.

O backup será difuso, porque o backup será consistente com um único ponto no tempo no histórico de transações, mas controlar o ponto exato no tempo não é possível no momento.

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

JET_ERR
JET_GRBIT
JET_INSTANCE
JetAttachDatabase
JetBeginExternalBackup
JetCloseFile
JetEndExternalBackup
JetEndExternalBackupInstance2
JetGetAttachInfo
JetGetLogInfo
JetOpenFile
JetReadFile
JetStopBackup
JetTruncateLog