JetStopBackup 関数

適用対象: Windows |Windows Server

JetStopBackup 関数

JetStopBackup 関数は、ストリーミング バックアップ関連のアクティビティが特定の実行中のインスタンスで継続するのを防ぎ、ストリーミング バックアップを予測可能な方法で終了します。

Windows XP: この関数は Windows XP で導入されています。

JetStopService は、インスタンスが 1 つだけ許可されている場合のレガシ呼び出しです。 この場合、アクティブなインスタンスは終了の準備をしているインスタンスだけです。

JET_ERR JET_API JetStopBackup(void);

パラメーター

この関数にはパラメーターはありません。

戻り値

この関数は、次のいずれかのリターン コードを使用して 、JET_ERR データ型を返します。 考えられる ESE エラーの詳細については、「 拡張可能ストレージ エンジン エラー 」および「 エラー処理パラメーター」を参照してください。

リターン コード	説明
JET_errSuccess	操作は正常に完了しました。
JET_errRunningInMultiInstanceMode	複数のインスタンス モードで JetStopService を使用する場合、終了の準備をするインスタンスは明確ではありません。 Windows XP: この戻り値は Windows XP で導入されています。

この関数が成功すると、インスタンスは新しいストリーミング バックアップ API の失敗を開始します。

この関数が失敗した場合、インスタンスのバックアップ終了を準備する手順は実行されません。また、インスタンスの状態に対する変更は行われません。

解説

バックアップは通常、プロセス メカニズムの外部のイベントによってトリガーされ、この API を使用すると、ESENT アプリケーション自体がストリーミング バックアップ API をさらに呼び出して失敗します。 ストリーミング バックアップ API の大部分は、JET_errBackupAbortByServerで失敗し始めます。 そのため、ストリーミング バックアップの進行状況 ( JetReadFileInstance など) はエラーを返します。 バックアップ終了の一部であるバックアップ操作 ( JetEndExternalBackupInstance など) は引き続き許可されます。

要件

要件	値
Client	Windows Vista、Windows XP、または Windows 2000 Professional が必要です。
[サーバー]	Windows Server 2008、Windows Server 2003、または Windows 2000 Server が必要です。
Header	Esent.h で宣言されています。
Library	ESENT.lib を使用します。
[DLL]	ESENT.dllが必要です。

参照

JetEndExternalBackupInstance
JET_ERR
JET_INSTANCE
JetReadFileInstance
JetStopService