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