JetEndExternalBackup 関数
適用対象: Windows |Windows Server
JetEndExternalBackup 関数
JetEndExternalBackup 関数は、外部バックアップ セッションを終了します。 この関数は、オンライン (VSS ベース以外の) バックアップを正常に実行するために呼び出す必要がある一連の API 要素の最後の API 要素です。
JET_ERR JET_API JetEndExternalBackup(void);
パラメーター
この関数にはパラメーターはありません。
戻り値
この関数は、次のいずれかのリターン コードを使用して 、JET_ERR データ型を返します。 考えられる ESE エラーの詳細については、「 拡張可能ストレージ エンジン エラー 」および「 エラー処理パラメーター」を参照してください。
リターン コード |
説明 |
---|---|
JET_errSuccess |
操作は正常に完了しました。 |
JET_errNotInitialized |
セッションに関連付けられているインスタンスがまだ初期化されていないため、操作を完了できません。 |
JET_errClientRequestToStopJetService |
JetStopService の呼び出しの結果、セッションに関連付けられているインスタンス上のすべてのアクティビティが停止したため、操作を完了できません。 |
JET_errInstanceUnavailable |
Windows XP: この戻り値は Windows XP で導入されています セッションに関連付けられているインスタンスで、そのデータの整合性を保護するためにすべてのデータへのアクセスを取り消す必要がある致命的なエラーが発生したため、操作を完了できません。 |
JET_errTermInProgress |
セッションに関連付けられているインスタンスがシャットダウンされているため、操作を完了できません。 |
JET_errRestoreInProgress |
セッションに関連付けられているインスタンスで復元操作が進行中のため、操作を完了できません。 |
JET_errNoBackup |
外部バックアップが進行中でないため、操作は失敗しました。 |
JET_errBackupAbortByServer |
Windows Server 2003: この戻り値は、Windows Server 2003 で導入されています。 JetStopBackup の呼び出しによって現在の外部バックアップが中止されたため、操作は失敗しました。 |
errBackupAbortByCaller |
Windows XP: この戻り値は Windows XP で導入されています。 呼び出し元は、 JetStopBackup で意図を通知することなく、バックアップ シーケンスの途中でバックアップを終了しました。 このエラーは、Windows Server 2003 以降のバックアップ クライアントのバグの結果です。 Windows XP では、外部バックアップ シーケンスが意図的に終了した場合に、このエラーが返されます。 |
JET_errRunningInMultiInstanceMode |
実際には複数のインスタンスが既に存在する場合、1 つのインスタンスのみがサポートされているレガシ モード (Windows 2000 互換モード) でエンジンを使用しようとしたため、操作は失敗しました。 |
この関数が成功した場合、外部バックアップは成功しました。 成功は、バックアップの種類 ( JetBeginExternalBackup で指定) に適したすべてのファイル (データベースやログなど) がバックアップ エンジンから取得されたことを示します。 バックアップされたファイルは、ハード リカバリー (JetExternalRestore) を使用して回復できます。
この関数が失敗した場合、外部バックアップは通常終了します。 エラーは、クライアントまたはアプリケーションの使用エラーが原因でバックアップが無効であることを意味します。 この API のリターン コードをチェックして、バックアップ シーケンスが成功したことを確認することが重要です。
解説
エンジンがイベントをログに記録するように構成されている場合は、外部バックアップの解決を示すイベントがログに記録されます。
バックアップ シーケンスが順番に完了せず、 JetEndExternalBackup の呼び出しが成功した場合、後続の増分バックアップには、予想されるアプリケーションよりも多くのデータが含まれる可能性があります。
外部バックアップ API シーケンスの詳細については、「 JetBeginExternalBackup」を参照してください。
Windows Vista より前では、ログの切り捨てが行われなかった場合、エンジンはバックアップがコピー バックアップであると見なしました。 ただし、バックアップは、切り捨てが行われなかった通常のバックアップである可能性があります (デタッチされたデータベースがある場合など)。 JET_bitBackupTruncateDone オプションを使用すると、エンジンにこのことを通知し、適切なデータベース ヘッダーの変更を許可できます。
要件
要件 | 値 |
---|---|
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が必要です。 |
参照
エラー処理パラメーター
記憶域エンジンの拡張可能なエラー
JetAttachDatabase
JetBeginExternalBackup
JetCloseFile
JET_ERR
JetExternalRestore
JetGetAttachInfo
JetGetLogInfo
JetOpenFile
JetReadFile
JetStopBackup
JetStopService
JetTruncateLog