次の方法で共有

JetBeginExternalBackupInstance 関数

  • [アーティクル]

適用対象: Windows |Windows Server

JetBeginExternalBackupInstance 関数

JetBeginExternalBackupInstance 関数は、エンジンとデータベースがオンラインでアクティブな間に外部バックアップを開始します。

Windows XP: JetBeginExternalBackupInstance は Windows XP で導入されました。

    JET_ERR JET_API JetBeginExternalBackupInstance(
      __in          JET_INSTANCE instance,
      __in          JET_GRBIT grbit
    );

パラメーター

instance

この呼び出しに使用するデータベース インスタンス。

Windows 2000 の場合、このパラメーターを受け入れる API バリアントは使用できません。サポートされているインスタンスは 1 つだけであるためです。 この場合、この 1 つのグローバル インスタンスの使用が暗黙的に示されます。

Windows XP 以降のリリースでは、このパラメーターを受け入れない API バリアントは、1 つのインスタンスのみがサポートされているレガシ モード (Windows 2000 互換モード) の場合にのみ呼び出すことができます。 それ以外の場合、操作はJET_errRunningInMultiInstanceModeで失敗します。

grbit

次のオプションの 0 個以上を指定するビットのグループ。

値

説明

JET_bitBackupAtomic

このフラグは非推奨です。 このビットを使用すると、JET_errInvalidgrbitが返されます。

JET_bitBackupIncremental

完全バックアップではなく、増分バックアップを作成します。 つまり、最後の完全バックアップまたは増分バックアップ以降のログ ファイルのみがバックアップされます。

JET_bitBackupSnapshot

将来利用するために予約されています。 Windows XP 用に定義されています。

戻り値

システムは、この関数の呼び出しの結果として成功コードまたは失敗コードを生成する可能性があります。 この API のエラーの完全な一覧については、「 拡張可能ストレージ エンジンのエラー コード」を参照してください。

JetBeginExternalBackup を参照してください。

注釈

JetBeginExternalBackupInstance は、オンライン (VSS ベース以外の) バックアップを正常に実行するために呼び出す必要がある一連の関数の最初の関数です。 JetBeginExternalBackup と JetStopBackupInstance も参照してください。

外部バックアップを使用して、完全バックアップ、増分バックアップ、または差分バックアップを実装できます。

バックアップはあいまいになり、バックアップはトランザクション履歴の 1 つの時点に一貫性がありますが、現時点では正確な時点を制御することはできません。

要件

要件 値

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が必要です。

参照

JET_ERR
JET_GRBIT
JET_INSTANCE
JetAttachDatabase
JetBeginExternalBackup
JetCloseFile
JetEndExternalBackup
JetEndExternalBackupInstance2
JetGetAttachInfo
JetGetLogInfo
JetOpenFile
JetReadFile
JetStopBackup
JetTruncateLog