JetOSSnapshotEnd 関数

適用対象: Windows |Windows Server

JetOSSnapshotEnd 関数は、スナップショットセッションが完了したことをエンジンに通知します。

Windows Vista:JetOSSnapshotEnd は Windows Vista で導入されました。

    JET_ERR JET_API JetOSSnapshotEnd(
      __in          const JET_OSSNAPID snapId,
      __in          const JET_GRBIT grbit
    );

snapId

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

grbit

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

値	説明
0	スナップショットセッションの正常終了。
JET_bitAbortSnapshot	スナップショットセッションが中止されました。

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

リターンコード	説明
JET_errSuccess	操作は正常に完了しました。
JET_errInvalidGrbit	要求されたオプションの 1 つが無効であるか、正しく使用されていないか、実装されていません。
JET_errOSSnapshotInvalidSequence	スナップショットセッションは既に進行中です。これは認められていません。
JET_errOSSnapshotInvalidSnapId	スナップショットセッションの識別子が無効です。
JET_errOSSnapshotTimeOut	この呼び出しが発生する前に、スナップショットセッションに内部タイムアウトがありました。その結果、IO 操作は、この呼び出しが行われる前に通常の状態に戻りました。

この関数が成功すると、スナップショットセッションが完了し、通常のエンジン動作が再開されます。新しいスナップショットセッションは、後で開始できます。

この関数が失敗した場合、JET_errOSSnapshotTimeOut戻りコードは戻り、現在のスナップショットセッションは終了しますが、スナップショット期間中の IO の凍結は内部的に尊重されませんでした。その他のすべてのエラーについては、スナップショットセッションの状態は変更されません。

この関数は、 JetOSSnapshotThaw が JET_bitContinueAfterThaw で呼び出された場合にのみ呼び出されます。

スナップショット検証とログの切り捨てが行われるには、スナップショットセッションを完了する必要があります。イベントログエントリは、スナップショットのさまざまな手順に対して生成されます。

フィードバック