Função JetIdle
Aplica-se a: Windows | Windows Server
Função JetIdle
A função JetIdle está desativada e só deve ser usada para fins de teste. O JetIdle pode ser usado para executar tarefas de limpeza ociosas ou marcar o repositório de versão status no ESE.
JET_ERR JET_API JetIdle(
__in JET_SESID sesid,
__in JET_GRBIT grbit
);
Parâmetros
sesid
A sessão que será usada para essa chamada.
grbit
Um grupo de bits que contém as opções a serem usadas para essa chamada, que incluem zero ou mais dos seguintes bits:
Valor |
Significado |
|---|---|
JET_bitIdleCompact |
Dispara a limpeza do repositório de versão. |
JET_bitIdleFlushBuffers |
Reservado para uso futuro. Se esse sinalizador for especificado, a API retornará JET_errInvalidgrbit. |
JET_bitIdleStatus |
Retorna JET_wrnIdleFull se o repositório de versão estiver mais da metade cheio. |
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 |
Um parâmetro grbit que foi fornecido à API não era válido. |
Se essa função for bem-sucedida, a operação apropriada será disparada ou um código de erro indicando o quão completo o repositório de versão está dependendo do grbit fornecido.
Se essa função falhar, a operação solicitada não terá sido concluída com êxito.
Comentários
O repositório de versão mantém o mecanismo de isolamento instantâneo do ESE. Se o repositório de versão estiver mais da metade cheio, o programa poderá fechar transações de execução longa. Se uma transação de execução prolongada esgotar o repositório de versão, o ESE deixará de permitir operações de gravação no banco de dados.
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. |