Função JetStopServiceInstance2

Aplica-se a: Windows | Windows Server

A função JetStopServiceInstance2 prepara uma instância antes de Suspender e prepara uma instância após Resume. Suspender e Retomar são estados de execução do modelo de ciclo de vida do aplicativo da Windows Store.

A função JetStopServiceInstance2 foi introduzida no Windows 8.

JET_ERR JET_API JetStopServiceInstance2(
  _In_          JET_INSTANCE       instance
  _In_          const JET_GRBIT    grbit
);

Parâmetros

instance

A instância de destino. O tipo de dados JET_INSTANCE é um identificador para a instância do banco de dados a ser usada para uma chamada à API JET. Esse identificador é obtido quando você cria uma instância do banco de dados chamando as funções JetCreateInstance, JetCreateInstance2, JetInit ou JetInit2 .

grbit

Um grupo de bits que especifica um ou mais dos valores listados e definidos na tabela a seguir.

Valor

Descrição

JET_bitStopServiceAll

Interrompe todos os serviços do Mecanismo de Armazenamento Extensível (ESE) para a instância especificada.

JET_bitStopServiceBackgroundUserTasks

Interrompe tarefas de manutenção em segundo plano especificadas pelo cliente reiniciáveis (Desfragmentação de Árvore B+, por exemplo).

JET_bitStopServiceQuiesceCaches

Corrige todos os caches sujo em disco. Esse valor é assíncrono e pode ser cancelado.

JET_bitStopServiceResume

Retoma operações StopService emitidas anteriormente; ou seja, ele reinicia o serviço. Esse valor pode ser combinado com o parâmetro grbits para retomar serviços específicos ou com JET_bitStopServiceAll para Retomar todos os serviços interrompidos anteriormente. Esse bit só pode ser usado para retomar StopServiceBackgroundUserTasks e JET_bitStopServiceQuiesceCaches. Se você tiver chamado anteriormente com JET_bitStopServiceAll, uma tentativa de usar JET_bitStopServiceResume falhará. Se a segunda etapa de retomada não for chamada, o aplicativo terá um desempenho degradado. Nessa situação, o ponto de verificação é mantido em zero.

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.

Código de retorno

Descrição

JET_errSuccess

A operação foi concluída com sucesso.

Comentários

Essa função permite que um aplicativo JET mova o cache do banco de dados para um limpo ou quase limpo estado (com a E/S do sistema operacional ociosa), de modo que, se o aplicativo fosse encerrado, a recuperação seria rápida. Essa abordagem é preferencial em vez de encerrar o JET chamando as funções JetTerm ou JetDetachDatabase , para que, no cenário mais comum, o aplicativo seja apenas não aberto e, posteriormente, o aplicativo tenha todo o cache e esteja pronto para ir o mais rápido possível.

Se essa função for bem-sucedida, ela preparará o cache do banco de dados para uma suspensão iminente. Essas filas de função funcionam para um thread de trabalho em segundo plano e retornam ao chamador imediatamente. A função deve ser chamada com base no PLM VisibilityNotice em vez de chamar do manipulador de eventos de suspensão do aplicativo para garantir que o JET tenha tempo para liberar sujo buffers antes que o PLM suspenda/encerre o processo. Internamente, o JET dispara uma expedição imediata da manutenção do ponto de verificação após a alteração da configuração (ou a atualização do ponto de verificação ou esse novo bit de cache de quiesce). Para obter mais informações sobre eventos VisibilityNotice, consulte Classe VisibilityChangedEventArgs.

Essa função deve ser chamada duas vezes. Ele é chamado depois que o aplicativo recebe o aviso de suspensão do sistema operacional, mas antes que o aplicativo seja suspenso. Em seguida, ele é chamado novamente depois que o sistema operacional retoma o aplicativo. Por exemplo:

Quando chamado para Suspend: JET_ERR JET_API JetStopServiceInstance2( instance, JET_bitStopServiceQuiesceCaches);

Quando retomado: JET_ERR JET_API JetStopServiceInstance2( instância, JET_bitStopServiceQuiesceCaches| JET_bitStopServiceResume );

Requisitos

Requisito Valor

Cliente

Requer Windows 8.

Servidor

Requer Windows Server 2012.

Cabeçalho

Declarado em Esent.h.

Biblioteca

Use ESENT.lib.

DLL

Requer ESENT.dll.

Confira também

JET_ERR
JET_INSTANCE
JetCloseDatabase
JetCloseTable
JetDetachDatabase
JetEndSession
JetResetSessionContext
JetRollback
JetTerm
JetTerm2

  • Last updated on