Funzione JetStopBackup
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