JetEndSession 関数

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

適用対象: Windows |Windows Server

JetEndSession 関数

JetEndSession 関数はセッションを終了し、指定されたセッションに関連付けられているリソースをクリーンアップして割り当てを解除します。

    JET_ERR JET_API JetEndSession(
      __in          JET_SESID sesid,
      __in          JET_GRBIT grbit
    );

パラメーター

sesid

終了するセッション。関連付けられているリソースは、セッションの終了時に解放されます。

grbit

予約済み。このパラメーターには JET_bitForceSessionClosed フラグを含めることができますが、このフラグは予約されており、設定しても効果はありません。

戻り値

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

リターンコード	説明
JET_errSuccess	操作は正常に完了しました。
JET_errClientRequestToStopJetService	JetStopService の呼び出しの結果、セッションに関連付けられたインスタンスのすべてのアクティビティが停止したため、操作を完了できません。
JET_errInvalidParameter	指定されたパラメーターの 1 つに予期しない値が含まれていたか、複数のパラメーター値の組み合わせによって予期しない結果が発生しました。
JET_errInvalidSesid	セッションが有効な JET セッションではなかった。
JET_errNotInitialized	セッションに関連付けられているインスタンスがまだ初期化されていないため、操作を完了できません。
JET_errOutOfMemory	メモリを割り当てられなかったため、操作に失敗しました。
JET_errSessionInUse	つまり、セッションが別のスレッドで使用されていたか、セッションが正しく設定またはリセットされませんでした。
JET_errInstanceUnavailable	セッションに関連付けられているインスタンスで、そのデータの整合性を保護するためにすべてのデータへのアクセスを取り消す必要がある致命的なエラーが発生したため、操作を完了できません。このエラーは、Windows XP 以降のリリースでのみ返されます。
JET_errOutOfBuffers	これ以上バッファーがないことを示すシステムエラー。
JET_errRestoreInProgress	セッションに関連付けられているインスタンスで復元操作が進行中のため、操作を完了できません。
JET_errTermInProgress	セッションに関連付けられているインスタンスがシャットダウンされているため、操作を完了できません。

成功すると、セッションハンドルは閉じられ、使用できず、このセッションに関連するすべてのリソースがクリーンアップされます。

失敗した場合、並べ替えテーブルのクローズ、カーソルのクローズ、トランザクションロールバックの一部として発生する可能性がある追加のエラーがいくつかあります。これらのエラーは非常に可能性が低く、 JetEndSession が呼び出されたときにセッションが完全に使用されていない場合は非常に可能性が低くなります。これらのエラーは、セッションの一部が正常にクリーンアップできなかった場合に返されます。

解説

この API は、(レベル 0 にコミットされていない) 開いているトランザクションをすべてロールバックします。また、このセッションに関連付けられているすべてのカーソルと、作成または開かれた並べ替えテーブルがクリーンアップされます。

必要条件

要件	値
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_GRBIT
JET_SESID
JetBeginSession
JetRollback
JetSetSystemParameter
JetStopService

次の方法で共有

JetEndSession 関数