Compartilhar via

Função JetStopServiceInstance

  • Artigo

Aplica-se a: Windows | Windows Server

Função JetStopServiceInstance

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

Windows XP:JetStopServiceInstance é introduzido no Windows XP.

    JET_ERR JET_API JetStopServiceInstance(
      __in          JET_INSTANCE instance
    );

Parâmetros

instance

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 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_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, 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 reduzirá o trabalho que a instância terá que fazer quando terminar, 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 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
JetCloseDatabase
JetCloseTable
JetDetachDatabase
JetEndSession
JetResetSessionContext
JetRollback
JetTerm
JetTerm2