Funzione JetEndSession

Si applica a: Windows | Windows Server

Funzione JetEndSession

La funzione JetEndSession termina la sessione e pulisce e dealloca tutte le risorse associate alla sessione specificata.

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

Parametri

sesid

Sessione da terminare. Le risorse associate vengono rilasciate al termine della sessione.

grbit

Riservato. Questo parametro può contenere il flag di JET_bitForceSessionClosed, ma questo flag è riservato e l'impostazione non ha alcun effetto.

Valore restituito

Questa funzione restituisce il tipo di dati JET_ERR con uno dei codici restituiti seguenti. Per altre informazioni sugli errori ESE possibili, vedere Errori del motore di archiviazione estendibili e parametri di gestione degli errori.

Codice restituito	Descrizione
JET_errSuccess	Operazione riuscita.
JET_errClientRequestToStopJetService	Non è possibile completare l'operazione perché tutte le attività nell'istanza associata alla sessione non sono state interrotte in seguito a una chiamata a JetStopService.
JET_errInvalidParameter	Uno dei parametri forniti contiene un valore imprevisto o la combinazione di diversi valori di parametro ha restituito un risultato imprevisto.
JET_errInvalidSesid	La sessione non è stata una sessione JET valida.
JET_errNotInitialized	Non è possibile completare l'operazione perché l'istanza associata alla sessione non è ancora stata inizializzata.
JET_errOutOfMemory	L'operazione non è riuscita perché la memoria non è stata allocata.
JET_errSessionInUse	Ciò significa che la sessione è stata usata in un altro thread oppure la sessione non è stata impostata o reimpostata correttamente.
JET_errInstanceUnavailable	Non è possibile completare l'operazione perché l'istanza associata alla sessione ha rilevato un errore irreversibile che richiede che l'accesso a tutti i dati venga revocato per proteggere l'integrità dei dati. Questo errore verrà restituito solo da Windows XP e versioni successive.
JET_errOutOfBuffers	Errore di sistema che indica che non sono presenti più buffer.
JET_errRestoreInProgress	Non è possibile completare l'operazione perché un'operazione di ripristino è in corso nell'istanza associata alla sessione.
JET_errTermInProgress	Non è possibile completare l'operazione perché l'istanza associata alla sessione viene arrestata.

In caso di esito positivo, l'handle di sessione viene chiuso e non è disponibile e tutte le risorse correlate a questa sessione vengono pulite.

In caso di errore, sono presenti diversi errori aggiuntivi che potrebbero verificarsi nell'ambito della chiusura della tabella di ordinamento, della chiusura del cursore e del rollback delle transazioni. Questi errori sono abbastanza improbabili e estremamente improbabili se le sessioni non sono completamente in uso quando Viene chiamato JetEndSession . Questi errori verranno restituiti se non è stato possibile pulire correttamente una parte della sessione.

Commenti

Questa API eseguirà il rollback di tutte le transazioni aperte (non eseguito il commit a livello 0). Tutti i cursori associati a questa sessione e tutte le tabelle di ordinamento create o aperte verranno eliminate.

Requisiti

Requisito	Valore
Client	Richiede Windows Vista, Windows XP o Windows 2000 Professional.
Server	Richiede Windows Server 2008, Windows Server 2003 o Windows 2000 Server.
Intestazione	Dichiarato in Esent.h.
Libreria	Usare ESENT.lib.
DLL	Richiede ESENT.dll.

Vedere anche

JET_GRBIT
JET_SESID
JetBeginSession
JetRollback
JetSetSystemParameter
JetStopService