JetStopBackup-Funktion
Gilt für: Windows | Windows Server
JetStopBackup-Funktion
Die JetStopBackup-Funktion verhindert, dass aktivitäten im Zusammenhang mit Streamingsicherungen auf einer bestimmten ausgeführten Instanz fortgesetzt werden, wodurch die Streamingsicherung auf vorhersagbare Weise beendet wird.
Windows XP: Diese Funktion wird in xp Windows eingeführt.
JetStopService ist der Legacyaufruf, wenn nur eine Instanz zulässig ist. In diesem Fall ist die einzige aktive Instanz die Instanz, die für die Beendigung vorbereitet wird.
JET_ERR JET_API JetStopBackup(void);
Parameter
Diese Funktion besitzt keine Parameter.
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_errRunningInMultiInstanceMode |
Es ist nicht klar, welche Instanz für die Beendigung vorbereitet werden soll, wenn JetStopService mit dem Modus für mehrere Instanzen verwendet wird. Windows XP: Dieser Rückgabewert wird in xp Windows eingeführt. |
Wenn diese Funktion erfolgreich ist, tritt bei der Instanz ein Fehler bei allen neuen Streamingsicherungs-APIs auf.
Wenn diese Funktion fehlschlägt, werden keine Schritte zum Vorbereiten der Sicherungsbeendigung auf der Instanz und keine Änderung des Instanzzustands unternommen.
Bemerkungen
Die Sicherung wird in der Regel durch ein Ereignis außerhalb des Prozessmechanismus ausgelöst, und mit dieser API ruft die ESENT-Anwendung selbst alle weiteren Aufrufe der Streamingsicherungs-APIs auf, um einen Fehler zu erhalten. Der Großteil der Streamingsicherungs-APIs wird mit einem Fehler JET_errBackupAbortByServer. Daher wird bei jedem Streamingsicherungsfortschritt (z. B. JetReadFileInstance)ein Fehler zurückgegeben. Sicherungsvorgänge, die Teil der Sicherungsbeendigung sind (z. B. JetEndExternalBackupInstance),sind weiterhin zulässig.
Anforderungen
| Anforderung | Wert |
|---|---|
Client |
Erfordert Windows Vista, Windows XP oder Windows 2000 Professional. |
Server |
Erfordert Windows Server 2008, Windows Server 2003 oder Windows 2000 Server. |
Header |
Wird in Esent.h deklariert. |
Bibliothek |
Verwenden Sie ESENT.lib. |
DLL |
Erfordert ESENT.dll. |
Weitere Informationen
JetEndExternalBackupInstance
JET_ERR
JET_INSTANCE
JetReadFileInstance
JetStopService