Função JetStopBackup

Aplica-se a: Windows | Windows Server

Função JetStopBackup

A função JetStopBackup impede que qualquer 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: Essa função é introduzida no Windows XP.

JetStopService é a chamada herdada quando apenas uma instância é permitida. Nesse caso, a única instância ativa é aquela que está sendo preparada para o encerramento.

JET_ERR JET_API JetStopBackup(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.

Se essa função for bem-sucedida, a instância 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á realizada 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á mais chamadas às 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

Consulte Também

JetEndExternalBackupInstance
JET_ERR
JET_INSTANCE
JetReadFileInstance
JetStopService