JetStopBackupInstance-Funktion

  • Artikel

Gilt für: Windows | Windows Server

JetStopBackupInstance-Funktion

Die JetStopBackupInstance-Funktion verhindert, dass die Streamingsicherungsaktivitäten auf einer bestimmten ausgeführten instance fortgesetzt werden, sodass die Streamingsicherung auf vorhersagbare Weise beendet wird.

Windows XP:JetStopBackupInstance wird in Windows XP eingeführt.

    JET_ERR JET_API JetStopBackupInstance(
      __in          JET_INSTANCE instance
    );

Parameter

instance

Gibt den ausgeführten instance an, der für den API-Aufruf verwendet werden soll.

Rückgabewert

Diese Funktion gibt den JET_ERR-Datentyp mit einem der folgenden Rückgabecodes zurück. Weitere Informationen zu möglichen ESE-Fehlern finden Sie unter Erweiterbare Speichermodulfehler und Fehlerbehandlungsparameter.

Rückgabecode

Beschreibung

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

JET_errInvalidParameter

Der angegebene instance Parameter hat einen ungültigen Wert (kein instance, der derzeit ausgeführt wird).

Windows XP: Dieser Rückgabewert wird in Windows XP eingeführt.

Wenn diese Funktion erfolgreich ist, tritt für die angegebene instance ein Fehler bei neuen Streamingsicherungs-APIs auf.

Wenn diese Funktion fehlschlägt, werden keine Schritte zur Vorbereitung des Sicherungsabbruchs auf dem instance ausgeführt, und es wird keine Änderung des instance Zustands durchgeführt.

Bemerkungen

Die Sicherung wird in der Regel durch ein Ereignis außerhalb des Prozessmechanismus ausgelöst, und mithilfe dieser API führt die ESENT-Anwendung selbst alle weiteren Aufrufe der Streamingsicherungs-APIs aus, um fehlschlagen zu können. Die meisten Streamingsicherungs-APIs treten mit JET_errBackupAbortByServer auf. Daher gibt jeder Fortschritt der Streamingsicherung (z. B. JetReadFileInstance) einen Fehler zurück. Sicherungsvorgänge, die Teil der Sicherungsbeendigung sind (z . B. JetEndExternalBackupInstance), sind weiterhin zulässig.

Anforderungen

Anforderung Wert

Client

Erfordert Windows Vista oder Windows XP.

Server

Erfordert Windows Server 2008 oder Windows Server 2003.

Kopfzeile

Deklariert in Esent.h.

Bibliothek

Verwenden Sie ESENT.lib.

DLL

Erfordert ESENT.dll.

Weitere Informationen

JET_ERR
JET_INSTANCE
JetEndExternalBackupInstance
JetReadFileInstance
JetStopService