JetStopBackupInstance-Funktion

Gilt für: Windows | Windows Server

JetStopBackupInstance-Funktion

Die JetStopBackupInstance-Funktion verhindert, dass sicherungsbezogene Streamingaktivitäten auf einer bestimmten ausgeführten Instanz fortgesetzt werden, wodurch 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

Instanz

Identifiziert die ausgeführte Instanz, die 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 den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine Errors and Error Handling Parameters.

Rückgabecode

Beschreibung

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

JET_errInvalidParameter

Der angegebene Instanzparameter weist einen ungültigen Wert auf (keine Instanz, die derzeit ausgeführt wird).

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

Wenn diese Funktion erfolgreich ist, schlägt die angegebene Instanz alle neuen Streamingsicherungs-APIs fehl.

Wenn diese Funktion fehlschlägt, werden keine Schritte zum Vorbereiten der Sicherungsbeendigung auf der Instanz ausgeführt, und es erfolgt keine Änderung des Instanzzustands.

Hinweise

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 einen Fehler zu erzielen. Für die meisten Streamingsicherungs-APIs tritt ein Fehler 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.

Header

Deklariert in Esent.h.

Bibliothek

Verwenden Sie ESENT.lib.

DLL

Erfordert ESENT.dll.

Weitere Informationen

JET_ERR
JET_INSTANCE
JetEndExternalBackupInstance
JetReadFileInstance
JetStopService