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.

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

Consulte Também

JET_ERR
JET_INSTANCE
JetEndExternalBackupInstance
JetReadFileInstance
JetStopService