Funzione JetStopService

Si applica a: Windows | Windows Server

Funzione JetStopService

La funzione JetStopService prepara un'istanza per la terminazione.

JetStopService è la chiamata legacy quando è consentita una sola istanza. In questo caso, l'unica istanza attiva è quella preparata per la terminazione.

    JET_ERR JET_API JetStopService(void);

Parametri

Questa funzione non ha parametri.

Valore restituito

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

Codice restituito

Descrizione

JET_errSuccess

Operazione riuscita.

JET_errRunningInMultiInstanceMode

Non è chiaro quale istanza preparare per la terminazione quando si usa JetStopService con più modalità di istanza.

Windows XP: Questo valore restituito viene introdotto in Windows XP.

Se questa funzione ha esito positivo, si prepara per una terminazione futura. I passaggi eseguiti per preparare una terminazione includono quanto segue:

  • Arrestare la deframmentazione online se è in esecuzione.

  • Avviare la pulizia di un archivio versioni.

  • Ridurre la profondità del checkpoint iniziando a scaricare pagine dirty nella gestione buffer.

  • Impedire chiamate future alla maggior parte delle funzioni per tale istanza.

Se questa funzione ha esito negativo, non verrà eseguita alcuna modifica allo stato dell'istanza per prepararsi per una terminazione dell'istanza, pertanto non verrà apportata alcuna modifica allo stato dell'istanza.

Commenti

Questa funzione riduce il lavoro che l'istanza dovrà eseguire al termine, ma non terminerà l'istanza. Di conseguenza, questa funzione è semplicemente un'ottimizzazione e non è obbligatoria da usare. Si noti che la quantità di lavoro svolto in preparazione era inferiore in Windows 2000 e Windows XP. Una volta completata la funzione, la chiamata di funzioni non più consentite restituirà JET_errClientRequestToStopJetService. Le funzioni ancora consentite dopo questa chiamata sono JetRollback, JetCloseTable, JetEndSession, JetCloseDatabase, JetDetachDatabase e JetResetSessionContext.

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_ERR
JET_INSTANCE
JetCloseDatabase
JetCloseTable
JetDetachDatabase
JetEndSession
JetResetSessionContext
JetRollback
JetTerm
JetTerm2