Função JetEndSession

Aplica-se a: Windows | Windows Server

Função JetEndSession

A função JetEndSession encerra a sessão e limpa e desaloca todos os recursos associados à sessão especificada.

    JET_ERR JET_API JetEndSession(
      __in          JET_SESID sesid,
      __in          JET_GRBIT grbit
    );

Parâmetros

sesid

A sessão a ser encerrada. Os recursos associados são liberados quando a sessão termina.

grbit

Reservado. Esse parâmetro pode conter o sinalizador JET_bitForceSessionClosed, mas esse sinalizador é reservado e defini-lo não tem efeito.

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.
JET_errClientRequestToStopJetService	Não é possível concluir a operação porque todas as atividades na instância associada à sessão cessaram como resultado de uma chamada para JetStopService.
JET_errInvalidParameter	Um dos parâmetros fornecidos continha um valor inesperado ou a combinação de vários valores de parâmetro gerava um resultado inesperado.
JET_errInvalidSesid	A sessão não era uma sessão JET válida.
JET_errNotInitialized	Não é possível concluir a operação porque a instância associada à sessão ainda não foi inicializada.
JET_errOutOfMemory	A operação falhou porque não foi possível alocar memória.
JET_errSessionInUse	Isso significa que a sessão estava em uso em outro thread ou a sessão não foi definida ou redefinida corretamente.
JET_errInstanceUnavailable	Não é possível concluir a operação porque a instância associada à sessão encontrou um erro fatal que exige que o acesso a todos os dados seja revogado para proteger a integridade desses dados. Esse erro só será retornado pelo Windows XP e versões posteriores.
JET_errOutOfBuffers	Erro do sistema que indica que não há mais buffers.
JET_errRestoreInProgress	Não é possível concluir a operação porque uma operação de restauração está em andamento na instância associada à sessão.
JET_errTermInProgress	Não é possível concluir a operação porque a instância associada à sessão está sendo desligada.

Em caso de êxito, o identificador de sessão é fechado e indisponível, e todos os recursos relacionados a essa sessão são limpos.

Em caso de falha, há vários erros adicionais que podem ocorrer como parte do fechamento da tabela de classificação, do fechamento do cursor e da reversão da transação. Esses erros são bastante improváveis e extremamente improváveis se suas sessões não estiverem completamente em uso quando JetEndSession for chamado. Esses erros serão retornados se alguma parte da sessão não puder ser limpa corretamente.

Comentários

Essa API reverterá todas as transações abertas (não confirmadas no nível 0). Além disso, todos os cursores associados a esta sessão e todas as tabelas de classificação que foram criadas ou abertas serão limpas.

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_GRBIT
JET_SESID
JetBeginSession
JetRollback
JetSetSystemParameter
JetStopService