JetDelete 関数

適用対象: Windows |Windows Server

JetDelete 関数

JetDelete 関数は、データベース テーブル内の現在のレコードを削除します。

    JET_ERR JET_API JetDelete(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid
    );

パラメーター

sesid

API 呼び出しに使用されるデータベース セッション コンテキスト。

tableid

データベース テーブル上のカーソル。 現在の行は削除されます。

戻り値

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

成功すると、通貨は次のレコードの直前に残ります。 削除されたレコードがテーブルの最後のレコードである場合、通貨はテーブルの末尾 (つまり、新しい最後のレコードの後) に残ります。 削除されたレコードがテーブル内の唯一のレコードである場合、通貨は先頭に設定されます。

適切なインデックスが自動的に更新されます。

更新プログラムが準備されている場合 ( JetPrepareUpdate を使用)、更新プログラムは取り消されます。 更新バッファーがリセットされます。

失敗した場合、通貨は変更されません。 更新プログラムが準備されている場合 ( JetPrepareUpdate を参照)、更新バッファーがリセットされる可能性があります。

注釈

すべてのテーブルで行の削除がサポートされているわけではありません。 一時テーブルは通常、行の削除をサポートしていません。 レコードの削除は、さまざまな理由で一時テーブルで有効にできます。その一部は次のとおりです。

• JET_bitTTUpdatableは作成時に指定されました。

• 大きな一時テーブルは、JET_bitTTScrollableまたはJET_bitTTIndexedを使用して作成された場合、削除をサポートできます。 一時テーブルが "大" になるしきい値は現在 64 KB ですが、今後のリリースで変更される可能性があります。

Windows XP 以降。 コールバック関数は、JET_cbtypBeforeDeleteやJET_cbtypAfterDeleteなど、 JetDelete によって呼び出すことができます。

1 つのトランザクション内で多数の更新操作を実行した場合の影響を理解することが重要です。 データベースに対する各更新は、バージョン ストア内のデータベース エンジンによって追跡される必要があります。 バージョン ストアには、データベース内の各レコードまたはインデックス エントリのすべての異なるバージョンのライブ レコードが保持され、すべてのアクティブなトランザクションで確認できます。 これらのバージョンは、データベース エンジンが使用する複数バージョンのコンカレンシー制御をサポートするために使用され、スナップショット分離を使用したトランザクションをサポートします。 データベース エンジンがこれらのバージョンの格納に使用するリソースを使い果たした後、一部のトランザクションでこれらのリソースの再利用が完了するまで、それ以上の変更を受け入れなくなります。 エンジンがこの状態になると、すべての更新はJET_errVersionStoreOutOfMemoryで失敗します。 データベース エンジンがこれらのバージョンを格納するために使用できるリソースは、 JetSetSystemParameter と JET_paramMaxVerPages と JET_paramGlobalMinVerPagesを使用して制御できます。

要件

参照

JET_ERR
JET_SESID
JET_TABLEID
JetOpenTempTable
JetPrepareUpdate
システム パラメーター