次の方法で共有

JetBeginTransaction2 関数

  • [アーティクル]

適用対象: Windows |Windows Server

JetBeginTransaction2 関数

JetBeginTransaction2 関数を使用すると、セッションでトランザクションを入力し、新しい保存ポイントを作成します。 この関数は、1 つのセッションで複数回呼び出して、追加の保存ポイントを作成できます。 これらの保存ポイントを使用して、データベースに対する変更を選択的に保持または破棄できます。

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

パラメーター

sesid

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

grbit

この呼び出しに使用するオプションを含むビットのグループ。これには、次の 0 個以上が含まれます。

値

説明

JET_bitTransactionReadOnly

トランザクションはデータベースを変更しません。 更新が試行された場合、その操作はJET_errTransReadOnlyで失敗します。 このオプションは、指定されたセッションがまだトランザクションに存在しない場合に要求されない限り無視されます。 このオプションは、Windows XP の時点でのみ使用できます。

戻り値

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

リターン コード

説明

JET_errSuccess

操作は正常に完了しました。

JET_errClientRequestToStopJetService

JetStopService の呼び出しの結果、セッションに関連付けられたインスタンスのすべてのアクティビティが停止したため、操作を完了できません。

JET_errInstanceUnavailable

セッションに関連付けられているインスタンスで、そのデータの整合性を保護するためにすべてのデータへのアクセスを取り消す必要がある致命的なエラーが発生したため、操作を完了できません。

このエラーは、Windows XP 以降のリリースでのみ返されます。

JET_errNotInitialized

セッションに関連付けられているインスタンスがまだ初期化されていないため、操作を完了できません。

JET_errRestoreInProgress

セッションに関連付けられているインスタンスで復元操作が進行中のため、操作を完了できません。

JET_errSessionSharingViolation

同じセッションを複数のスレッドに同時に使用することはできません。 このエラーは、Windows XP 以降のリリースでのみ返されます。

JET_errTermInProgress

セッションに関連付けられているインスタンスがシャットダウンされているため、操作を完了できません。

JET_errTransTooDeep

セッションがデータベース エンジンで許容される最大保存ポイント深度に既に存在するため、新しいトランザクションを開始できません。

成功すると、指定されたセッションはトランザクション内になります。 セッションが以前にトランザクション内にあった場合は、新しい保存ポイントが作成されます。

失敗した場合、セッションのトランザクション状態は変更されません。 データベースの状態に対する変更は行われません。

解説

トランザクションのしくみの詳細については、「 JetBeginTransaction」を参照してください。

必要条件

要件 値

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_ERR
JET_GRBIT
JET_SESID
JetBeginTransaction
JetCommitTransaction
JetGetSystemParameter
JetResetSessionContext
JetRollback
JetSetSessionContext
システム パラメーター