Funzione JetStopBackupInstance
Si applica a: Windows | Windows Server
Funzione JetStopBackupInstance
La funzione JetStopBackupInstance impedisce di continuare l'attività correlata al backup di streaming in un'istanza di esecuzione specifica, terminando così il backup di streaming in modo prevedibile.
Windows XP:JetStopBackupInstance viene introdotto in Windows XP.
JET_ERR JET_API JetStopBackupInstance(
__in JET_INSTANCE instance
);
Parametri
Istanza
Identifica l'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, l'istanza specificata inizierà ad avere esito negativo in qualsiasi nuova API di backup di streaming.
Se questa funzione non riesce, non verranno eseguiti passaggi per la chiusura del backup nell'istanza e non verrà eseguita 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 eseguirà ulteriori 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 di avanzamento 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 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
JetEndExternalBackupInstance
JetReadFileInstance
JetStopService