Condividi tramite

Funzione JetStopBackup

  • Articolo

Si applica a: Windows | Windows Server

Funzione JetStopBackup

La funzione JetStopBackup impedisce a qualsiasi attività correlata al backup di streaming di continuare in un'istanza in esecuzione specifica, terminando quindi il backup di streaming in modo prevedibile.

Windows XP: Questa funzione viene introdotta in Windows XP.

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 JetStopBackup(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, l'istanza inizierà a non riuscire con le nuove API di backup di streaming.

Se questa funzione non riesce, non verranno eseguiti passaggi per preparare la terminazione del backup nell'istanza e non verrà apportata alcuna modifica allo stato dell'istanza.

Commenti

Il backup viene in genere attivato da un evento all'esterno del meccanismo di processo e tramite questa API, l'applicazione ESENT stessa effettuerà altre chiamate alle API di backup di streaming per avere esito negativo. La maggior parte delle API di backup di streaming inizierà a non riuscire con JET_errBackupAbortByServer. Di conseguenza, qualsiasi stato del backup di streaming ,ad esempio JetReadFileInstance, restituirà un errore. Le operazioni di backup che fanno parte della terminazione del backup (ad esempio JetEndExternalBackupInstance) saranno comunque consentite.

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

JetEndExternalBackupInstance
JET_ERR
JET_INSTANCE
JetReadFileInstance
JetStopService