JetSetSessionContext 関数

適用対象: Windows |Windows Server

JetSetSessionContext 関数

JetSetSessionContext 関数は、指定されたコンテキスト ハンドルを使用して、セッションを現在のスレッドに関連付けます。 この関連付けにより、特定のセッションのトランザクションが完全に同じスレッドで実行される必要がある既定のエンジン要件がオーバーライドされます。

    JET_ERR JET_API JetSetSessionContext(
      __in          JET_SESID sesid,
      __in          JET_API_PTR ulContext
    );

パラメーター

sesid

この呼び出しに使用するセッション。

ulContext

このセッションが関連付けられる一意の識別子。

戻り値

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

この関数が成功すると、セッションは現在のスレッドに関連付けられます。 データベースの状態は変更されません。

この関数が失敗した場合、セッションの状態は変更されません。 データベースの状態は変更されません。

注釈

セッションは通常、トランザクションの間、特定のスレッドにバインドされます。 この動作は、アプリケーションが複数のスレッド間で 1 つのセッションを概念的に不適切に共有することを検出して防ぐのに役立つよう設計されています。 場合によっては、この単純なチェックはアプリケーションのアーキテクチャでは機能しません。 たとえば、アプリケーションがスレッド プールを使用してサーバー側オブジェクトをホストしていて、トランザクションが特定のオブジェクトに対する複数のサーバー呼び出しにまたがる場合、この保護により、使用パターンが正しい場合でも、これらの呼び出しの一部が JET_errSessionSharingViolation で失敗する可能性があります。 この状況は、COM オブジェクト サーバーで一般的です。

JetSetSessionContext と JetResetSessionContext は、このセッション共有チェックもう少し柔軟にすることで、この問題を解決します。 アプリケーションは、特定のセッションを使用して一連の ESE API 呼び出しを開始すると、最初にセッション コンテキストを特定の値に設定します。 このアクションにより、セッションが呼び出し元のスレッドに関連付けられます。 この例では、このコンテキストは、JET セッション ハンドルを含むオブジェクトのアドレスである可能性があります。 ESE API 呼び出しが行われると、アプリケーションはセッション コンテキストをリセットします。 このアクションにより、呼び出し元スレッドからセッションの関連付けが解除されます。 オブジェクトとそのセッションは、セッションにアクティブなトランザクションがある場合でも、別のスレッドで使用できます。

そのセッションでトランザクションを開く前に JetSetSessionContext を呼び出す必要があります。または、関連付けが機能しないことに注意してください。

JetSetSessionContext はスレッド セーフです。 複数のスレッドが同時に同じセッションにスレッド コンテキストを設定しようと試みることができ、1 つだけが優先されます。 この事実は、割り当てに関する外部状態を格納せずに、プールからセッションを割り当てる手段としてアプリケーションで使用できます。

要件

参照

JET_API_PTR
JET_ERR
JetResetSessionContext
JET_SESID
JetStopService