JetOSSnapshotAbort 関数

[アーティクル]
06/13/2023

適用対象: Windows |Windows Server

JetOSSnapshotAbort 関数

JetOSSnapshotAbort 関数は、凍結期間が失敗したスナップショットで終了した後、通常の IO 操作を再開できることをエンジンに通知します。

Windows Server 2003:JetOSSnapshotAbort は Windows Server 2003 で導入されました。

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

パラメーター

snapId

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

grbit

この呼び出しのオプション。このパラメーターは将来使用するために予約されており、サポートされる有効な値は 0 (ゼロ) のみです。

戻り値

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

リターンコード	説明
JET_errSuccess	操作は正常に完了しました。
JET_errInvalidParameter	スナップショットセッションが無効であるか、grbit パラメーターが無効です。
JET_errOSSnapshotInvalidSnapId	スナップショットセッションの識別子が無効です。

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

この関数が失敗した場合、スナップショットセッションは中止されません。

解説

この関数は、エンジンに関連しない理由でスナップショットが中止されたことをエンジンに通知するために、JetOSSnapshotThaw の代わりに呼び出す必要があります。この情報は、後で、スナップショットセッションに関するイベントログメッセージを発行したり、他の適切なアクションを特定したりするために使用できます。

必要条件

要件	値
Client	Windows Vista が必要です。
[サーバー]	Windows Server 2008 または Windows Server 2003 が必要です。
Header	Esent.h で宣言されています。
Library	ESENT.lib を使用します。
[DLL]	ESENT.dllが必要です。

参照

JET_ERR
JET_OSSNAPID
JetOSSnapshotFreeze
JetOSSnapshotPrepare
JetOSSnapshotThaw

次の方法で共有

JetOSSnapshotAbort 関数