Função JetStopBackupInstance

Aplica-se a: Windows | Windows Server

Função JetStopBackupInstance

A função JetStopBackupInstance impede que a atividade relacionada ao backup de streaming continue em uma instância de execução específica, encerrando assim o backup de streaming de maneira previsível.

Windows XP:JetStopBackupInstance é introduzido no Windows XP.

    JET_ERR JET_API JetStopBackupInstance(
      __in          JET_INSTANCE instance
    );

Parâmetros

instance

Identifica a instância em execução a ser usada para a chamada à API.

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_errInvalidParameter	O parâmetro de instância especificado tem um valor inválido (não uma instância que está em execução no momento). Windows XP: Esse valor retornado é introduzido no Windows XP.

Se essa função for bem-sucedida, a instância especificada começará a falhar em novas APIs de backup de streaming.

Se essa função falhar, nenhuma etapa para se preparar para a terminação de backup na instância será executada e nenhuma alteração no estado da instância ocorrerá.

Comentários

O backup geralmente é disparado por um evento fora do mecanismo de processo e, usando essa API, o próprio aplicativo ESENT fará outras chamadas para as APIs de backup de streaming para falhar. A maioria das APIs de backup de streaming começará a falhar com JET_errBackupAbortByServer. Dessa forma, qualquer progresso de backup de streaming (como JetReadFileInstance) retornará um erro. As operações de backup que fazem parte da terminação de backup (como JetEndExternalBackupInstance) ainda serão permitidas.

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

JET_ERR
JET_INSTANCE
JetEndExternalBackupInstance
JetReadFileInstance
JetStopService