JET_CALLBACK コールバック関数

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

適用対象: Windows |Windows Server

JET_CALLBACK コールバック関数

JET_CALLBACK関数は、オンライン最適化とカーソル状態通知を含むイベントをアプリケーションに通知するためにデータベースエンジンによって使用される多目的コールバック関数です。

cbtyp パラメーターで使用するために選択されているJET_CBTYPオプションによってこれらの設定が異なるため、この関数のパラメーターに使用する特定の設定については、「JET_CBTYP」を参照してください。

    JET_ERR JET_API* JET_CALLBACK(
      [in]                 JET_SESID sesid,
      [in]                 JET_DBID dbid,
      [in]                 JET_TABLEID tableid,
      [in]                 JET_CBTYP cbtyp,
      [in, out]            void* pvArg1,
      [in, out]            void* pvArg2,
      [in]                 void* pvContext,
      [in]                 JET_API_PTR ulUnused
    );

パラメーター

sesid

コールバックが行われているセッション。

dbid

コールバックが行われているデータベース。

tableid

コールバックが行われているカーソル。

cbtyp

コールバックが行われている操作のポイント。各ケースの値と次のパラメーターの意味の一覧については、「 JET_CBTYP 」を参照してください。

pvArg1

コールバックを使用してアプリケーションと通信するために使用されるパラメーター。データベースエンジンでサポートされている各コールバックに対するこのパラメーターの使用については、「 JET_CBTYP 」を参照してください。

pvArg2

pvContext

ulUnused

戻り値

関数は、拡張可能記憶域エンジンのエラーコードのいずれかを返します。これらのコードを HRESULT として返す方法については、「記憶域エンジンの拡張エラー」を参照してください。成功した場合、コールバックを発行した操作は正常に続行できます。場合によっては、コールバックは、その操作に影響を与える警告を返す場合があります。操作によるこれらの警告の使用については、「 JET_CBTYP 」を参照してください。

失敗した場合、コールバックを発行した操作は正常に続行されるか、失敗する可能性があります。操作によるエラーコードの使用については、「 JET_CBTYP 」を参照してください。

解説

コールバックがアプリケーションにカーソルを渡す場合は、再帰やその他のあいまいさを避けるために、このカーソルが意図的に小さな機能セットに制限されていることを知しておくことが重要です。次の操作を実行できます。

コールバックを設計するときは、これらの制限がある場合でも、コールバックが失敗する可能性があることを考慮してください。

要件

要件	値
Client	Windows Vista、Windows XP、または Windows 2000 Professional が必要です。
[サーバー]	Windows Server 2008、Windows Server 2003、または Windows 2000 Server が必要です。
Header	Esent.h で宣言されています。

参照

JET_API_PTR
JET_DBID
JET_SESID
JET_TABLEID
JET_CBTYP

次の方法で共有

JET_CALLBACK コールバック関数

JET_CALLBACK コールバック関数

パラメーター

戻り値

解説

要件

参照

フィードバック

その他のリソース