JET_USERDEFINEDDEFAULT構造体

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

適用対象: Windows |Windows Server

JET_USERDEFINEDDEFAULT構造体

JET_USERDEFINEDDEFAULT構造体は、コールバックを使用して決定される既定値を新しい列に与えるために、JET_bitColumnUserDefinedDefaultと組み合わせて指定されます。この手法を使用して、計算列を実装できます。

Windows XP:JET_USERDEFINEDDEFAULT構造は、Windows XP で導入されています。

    typedef struct tag_JET_USERDEFINEDDEFAULT {
      tchar* szCallback;
      unsigned char* pbUserData;
      unsigned long cbUserData;
      tchar* szDependantColumns;
    } JET_USERDEFINEDDEFAULT;

メンバー

szCallback

コールバックを実装する関数のエクスポート名を "module!function" 形式で指定します。

コールバックは、列スキーマの一部として保持されます。関数の実際のホスト実行可能ファイルとエクスポート名は、実行時に関数の true アドレスの検索を有効にするために保持する必要があります。

モジュール名は、関数を含むホストバイナリの名前です。関数名は、その関数のエクスポートの名前です。これらの 2 つの情報は、実行時にデータベースエンジンによって使用され、モジュール名に対して LoadLibrary 呼び出しを実行し、関数名に対する GetProcAddress 呼び出しを実行することで、コールバックの真のアドレスを特定します。

たとえば、コールバックが MyCallback.DLL という DLL に実装され、その DLL が C:\MyApplication に格納され、コールバックを実装する関数が DLL から UserDefinedDefaultCallback としてエクスポートされた場合、必要な文字列は "C:\MyApplication\MyCallback.DLL!UserDefinedDefaultCallback"

メモコールバック名のモジュール部分に埋め込まれた "!" 文字はサポートされていません。

ホストアーキテクチャの関数ではないコールバック名を使用することを強くお勧めします。たとえば、この呼び出し規則は x86 マシンでのみサポートされているため、stdcall (UserDefinedDefaultCallback@32) として装飾されたエクスポートは使用しないでください。このようなコールバックが使用された場合、データベースは x86 マシンでのみ使用できます。この場合、プラットフォームに依存しないエクスポートを行うには、エイリアスを使用する必要があります。

コールバックを実装するモジュール名の完全パスを使用することを強くお勧めします。相対パスが使用されている場合、データベースをホストしているプロセスは、不正なバイナリによる攻撃の影響を受ける可能性があります。

アプリケーションは、信頼されたコールバックのみをデータベースエンジンに渡す必要があります。データベースエンジンはバイナリを読み込み、関連付けられた列の作成時にその存在を確認します。バイナリへのパスが検証されていないか、信頼されていることがわかっていない場合は、データベースをホストしているプロセスが攻撃される可能性があります。

pbUserData

呼び出されたときにコールバックに渡されるユーザー定義データの自己完結型ブロック。指定されたデータブロックは、列スキーマの一部として保持されます。その結果、データブロックは完全に自己完結型である必要があり、データベースの範囲外のデータを参照することはできません。

pbUserData が 0 の場合、cbUserData の値は無視されます。この場合、呼び出されたときにユーザー定義データはコールバックに渡されません。

cbUserData

pbUserData に関するページを参照してください。

szDependantColumns

将来利用するために予約されています。

このメンバーは常に NULL に設定する必要があります。

必要条件

要件	値
Client	Windows Vista、Windows XP、または Windows 2000 Professional が必要です。
[サーバー]	Windows Server 2008、Windows Server 2003、または Windows 2000 Server が必要です。
Header	Esent.h で宣言されています。
Unicode	JET_ USERDEFINEDDEFAULT_W (Unicode) およびJET_ USERDEFINEDDEFAULT_A (ANSI) として実装されます。

参照

JET_CBTYP
JET_COLUMNCREATE
JET_COLUMNDEF

Share via

JET_USERDEFINEDDEFAULT構造体