Função JetStopService

Aplica-se a: Windows | Servidor Windows

Função JetStopService

A função JetStopService prepara uma instância para o encerramento.

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 JetStopService(void);

Parâmetros

Essa função não tem parâmetros.

Valor de retorno

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 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_errRunningInMultiInstanceMode

Não está claro qual instância preparar para o encerramento ao usar JetStopService com o modo de várias instâncias.

Windows XP: esse valor retornado é introduzido em Windows XP.

Se essa função for bem-sucedida, ela se preparará para uma terminação futura. As etapas tomadas para se preparar para uma terminação incluem o seguinte:

  • Interrompa o desfragmentação online se ele estiver em execução.

  • Inicie uma limpeza do repositório de versão.

  • Reduza a profundidade do ponto de verificação começando a liberar páginas sujas no gerenciador de buffers.

  • Impedir chamadas futuras para a maioria das funções para essa instância.

Se essa função falhar, nenhuma das etapas para se preparar para uma terminação de instância será executada, portanto, nenhuma alteração no estado da instância ocorrerá.

Comentários

Essa função reduz o trabalho que a instância terá que fazer quando terminada, mas não encerrará a instância. Como resultado, essa função é apenas uma otimização e não é obrigatória para uso. Observe que a quantidade de trabalho feito na preparação foi menor em Windows 2000 e Windows XP. Depois que a função for bem-sucedida, chamar funções que não são mais permitidas retornará JET_errClientRequestToStopJetService. As funções que ainda são permitidas após essa chamada são: JetRollback, JetCloseTable, JetEndSession, JetCloseDatabase, JetDetachDatabase e JetResetSessionContext.

Requisitos

Requisito Valor

Cliente

Requer Windows Vista, Windows XP ou Windows 2000 Professional.

Servidor

Requer Windows Server 2008, Windows Server 2003 ou Windows 2000 Server.

Cabeçalho

Declarado em Esent.h.

Biblioteca

Use ESENT.lib.

DLL

Requer ESENT.dll.

Consulte Também

JET_ERR
JET_INSTANCE
JetCloseDatabase
JetCloseTable
JetDetachDatabase
JetEndSession
JetResetSessionContext
JetRollback
JetTerm
JetTerm2