JetDupSession 関数

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

適用対象: Windows |Windows Server

JetDupSession 関数

JetDupSession 関数はセッションを開始し、ESE セッションハンドル (JET_SESID) を初期化して返します。セッションはデータベースへのすべてのアクセスを制御し、トランザクションのスコープを制御するために使用されます。セッションを使用して、トランザクションの開始、コミット、または中止を行うことができます。セッションは、データベースのアタッチ、作成、または開きにも使用されます。セッションは、すべての DDL および DML 操作のコンテキストとして使用されます。データベースへのコンカレンシーと並列アクセスを増やすには、複数のセッションを開始できます。

メモこの API は、渡されたセッションのインスタンスで呼び出された JetBeginSession としてあらゆる方法で機能します。この関数はお勧めしません。 JetBeginSession をお勧めします。

    JET_ERR JET_API JetDupSession(
      __in          JET_SESID sesid,
      __out         JET_SESID* psesid
    );

パラメーター

sesid

セッションを複製または開始するためのソースとして使用するセッション。

psesid

正常な戻り時にセッションハンドルが初期化する変数へのポインター。

戻り値

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

リターンコード	説明
JET_errSuccess	操作は正常に完了しました。
JET_errClientRequestToStopJetService	JetStopService の呼び出しの結果、セッションに関連付けられたインスタンス上のすべてのアクティビティが停止したため、操作を完了することはできません。
JET_errInstanceUnavailable	セッションに関連付けられているインスタンスで致命的なエラーが発生したため、操作を完了できません。このエラーでは、そのデータの整合性を保護するためにすべてのデータへのアクセスを取り消す必要があります。このエラーは、Windows XP 以降のリリースでのみ返されます。
JET_errInvalidParameter	指定されたパラメーターの 1 つに、予期しない値が含まれていたか、別のパラメーターの値と組み合わせると意味のない値が含まれていました。
JET_errNotInitialized	セッションに関連付けられているインスタンスがまだ初期化されていないため、操作を完了できません。
JET_errOutOfMemory	メモリを割り当てられなかったため、操作が失敗しました。
JET_errOutOfSessions	エンジンがクライアントの起動を許可するセッションの数は限られています。この値は、 JetSetSystemParameter と JET_paramMaxSessions 定数を使用して変更できます。セッションの既定の数は 16 です。 JET_paramMaxSessionsの詳細については、「システムパラメーター」を参照してください。
JET_errRestoreInProgress	セッションに関連付けられているインスタンスで復元操作が進行中であるため、操作を完了できません。
JET_errTermInProgress	セッションに関連付けられているインスタンスがシャットダウンされているため、操作を完了できません。

成功すると、セッションハンドルが初期化され、データベース操作に使用できます。

失敗した場合、使用可能なセッションがないか、新しいセッションを初期化できませんでした。

必要条件

要件	値
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_SESID
JetBeginSession
JetSetSystemParameter
JetStopService
システムパラメーター

次の方法で共有

JetDupSession 関数