JetOpenTable 関数

適用対象: Windows |Windows Server

JetOpenTable 関数

JetOpenTable 関数は、以前に作成したテーブルにカーソルを開きます。

    JET_ERR JET_API JetOpenTable(
      __in          JET_SESID sesid,
      __in          JET_DBID dbid,
      __in          const tchar* szTableName,
      __in_opt      const void* pvParameters,
      __in          unsigned long cbParameters,
      __in          JET_GRBIT grbit,
      __out         JET_TABLEID* ptableid
    );

パラメーター

sesid

使用するデータベース セッション コンテキスト。

dbid

テーブルの検索に使用するデータベース識別子。

szTableName

開くテーブルの名前。

pvParameters

非推奨になりました。 NULL に設定 します。

cbParameters

非推奨になりました。 0 (ゼロ) に設定します。

grbit

次のオプションの 0 個以上を指定するビットのグループ。

ptableid

成功した場合は、テーブルの識別子をポイントします。 失敗した場合、 ptableid の内容は未定義です。

戻り値

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

解説

JetOpenTable で開かれたテーブルは、通常、JetCloseTable で閉じる必要があります。 このルールの例外は、 トランザクションで JetOpenTable が呼び出され、トランザクションがロールバックされた場合に発生します ( JetRollback を使用)。 トランザクションをロールバックすると、テーブルは自動的に閉じられます。 この場合、 JetCloseTable を使用してテーブルを閉じるとエラーが発生します。

JetOpenTable (MSysObjects、MSysUnicodeFixup など) を使用してシステム テーブルを開くのは有効です。 システム テーブルのスキーマが変更される可能性があるため、システム テーブルへのアクセスはお勧めしません。 同時に開くことができる一意のテーブルの数は、 JET_paramMaxOpenTablesによって直接影響を受けます。 テーブルが現在開いている場合は、テーブルに新しいカーソルが作成されます。 カーソル リソースは、JET_paramMaxCursorsで JetSetSystemParameter を使用して構成されます。 JetDupCursor も参照してください。

要件

参照

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetCloseTable
JetDupCursor
JetRollback
JetSetSystemParameter
リソース パラメーター