次の方法で共有

JetOSSnapshotTruncateLogInstance 関数

適用対象: Windows |Windows Server

JetOSSnapshotTruncateLogInstance 関数

JetOSSnapshotTruncateLogInstance 関数は、スナップショット セッション中に指定されたインスタンスのログを切り捨てます。

Windows Vista:JetOSSnapshotTruncateLogInstance は Windows Vista で導入されています。

    JET_ERR JET_API JetOSSnapshotTruncateLogInstance(
      __in          const JET_OSSNAPID snapId,
      __in          JET_INSTANCE instance,
      __in          const JET_GRBIT grbit
    );

パラメーター

snapId

スナップショット セッションの識別子。

instance

この呼び出しに使用されるインスタンス。

grbit

この呼び出しのオプション。 このパラメーターには、次の値の組み合わせを指定できます。

grbit には、次のいずれかの値を指定できます。

値

説明

JET_bitAllDatabasesSnapshot

ストレージ エンジンがログの切り捨てを計算して実行できるように、すべてのデータベースがアタッチされます。

0 (ゼロ)

切り捨ては行われません。

戻り値

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

リターン コード

説明

JET_errSuccess

操作は正常に完了しました。

JET_errInvalidGrbit

grbit パラメーターが無効です。

JET_errOSSnapshotInvalidSequence

スナップショット セッションは、切り捨てが発生する可能性がある状態ではありません。 次の原因が考えられます。

  • 呼び出しは、スナップショット セッションがタイムアウトした後に完了します。

  • セッションがコピー スナップショットとして指定されました。

この関数が成功すると、可能であれば、スナップショット セッションの一部である 1 つまたはすべてのインスタンスのログ ファイルが切り捨てられます。

注釈

この関数は、スナップショットが JET_bitContinueAfterThaw オプションで作成された場合にのみ呼び出す必要があります。 それ以外の場合、スナップショット セッションは JetOSSnapshotThaw の呼び出しの後に終了します。

要件

要件 値

Client

Windows Vista が必要です。

[サーバー]

Windows Server 2008 が必要です。

Header

Esent.h で宣言されています。

Library

ESENT.lib を使用します。

[DLL]

ESENT.dllが必要です。

参照

エラー処理パラメーター
拡張可能なストレージ エンジン エラー
JET_ERR
JetOSSnapshotEnd
JetOSSnapshotFreeze
JetOSSnapshotPrepare
JetOSSnapshotThaw