JetStopBackup 関数

適用対象: Windows |Windows Server

JetStopBackup 関数

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

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

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

JET_ERR JET_API JetStopBackup(void);

パラメーター

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

戻り値

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

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

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

解説

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

要件

参照

JetEndExternalBackupInstance
JET_ERR
JET_INSTANCE
JetReadFileInstance
JetStopService