Função JetResetSessionContext

Aplica-se a: Windows | Windows Server

Função JetResetSessionContext

A função JetResetSessionContext desassocia uma sessão do thread atual.

    JET_ERR JET_API JetResetSessionContext(
      __in          JET_SESID sesid
    );

Parâmetros

sesid

A sessão a ser usada para essa chamada.

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_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_errNotInitialized

Não é possível concluir a operação porque a instância associada à sessão ainda não foi inicializada.

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_errSessionContextNotSetByThisThread

A sessão não pôde ser desassociada do thread atual porque está associada a um thread diferente.

JET_errTermInProgress

Não é possível concluir a operação porque a instância associada à sessão está sendo desligada.

Com êxito, a sessão será desassociada do thread atual. Nenhuma alteração no estado do banco de dados ocorrerá.

Em caso de falha, o estado da sessão permanecerá inalterado. Nenhuma alteração no estado do banco de dados ocorrerá.

Comentários

JetResetSessionContext deve ser chamado no mesmo thread que chamou JetSetSessionContext para uma determinada sessão.

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_API_PTR
JET_ERR
JET_SESID
JetSetSessionContext