Condividi tramite

Funzione JetStopServiceInstance

  • Articolo

Si applica a: Windows | Windows Server

Funzione JetStopServiceInstance

La funzione JetStopServiceInstance prepara un'istanza per la terminazione.

Windows XP:JetStopServiceInstance viene introdotto in Windows XP.

    JET_ERR JET_API JetStopServiceInstance(
      __in          JET_INSTANCE instance
    );

Parametri

Istanza

Istanza in esecuzione da usare per la chiamata API.

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_errInvalidParameter

Il parametro dell'istanza specificato ha un valore non valido (non un'istanza attualmente in esecuzione).

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

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

  • Arrestare la deframmentazione online se è in esecuzione.

  • Avviare una pulizia dell'archivio versioni.

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

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

Se questa funzione ha esito negativo, none i passaggi da preparare per una terminazione dell'istanza verranno eseguiti, quindi non verrà eseguita alcuna modifica allo stato dell'istanza.

Commenti

Questa funzione ridurrà il lavoro che l'istanza dovrà eseguire quando viene terminata, ma non termina l'istanza. Di conseguenza, questa funzione è solo un'ottimizzazione e non è obbligatoria per l'uso. Si noti che la quantità di lavoro eseguita in preparazione era minore in Windows 2000 e Windows XP. Una volta completata la funzione, le funzioni che non sono più consentite restituiranno JET_errClientRequestToStopJetService. Le funzioni ancora consentite dopo questa chiamata sono: JetRollback, JetCloseTable, JetEndSession, JetCloseDatabase, JetDetachDatabase e JetResetSessionContext.

Requisiti

Requisito Valore

Client

Richiede Windows Vista o Windows XP.

Server

Richiede Windows Server 2008 o Windows Server 2003.

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