JET_USERDEFINEDDEFAULT構造体
適用対象: 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) として実装されます。 |