Compartilhar via


Função JetStopService

Aplica-se a: Windows | Windows Server

Função JetStopService

A função JetStopService prepara uma instância para 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 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.

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 terminação ao usar JetStopService com modo de várias instâncias.

Windows XP: Esse valor retornado é introduzido no Windows XP.

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

  • Pare a desfragmentação online se ela estiver em execução.

  • Inicie um repositório de versão limpo.

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

  • Impedir chamadas futuras para a maioria das funções dessa 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 no Windows 2000 e no 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 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_INSTANCE
JetCloseDatabase
JetCloseTable
JetDetachDatabase
JetEndSession
JetResetSessionContext
JetRollback
JetTerm
JetTerm2