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