Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.
外部事前フィルタのインスタンスを初期化し、データの文字セットをネゴシエートするエントリポイント関数。
extern "C" a_sql_uint32 ( SQL_CALLBACK *entry-point-function )( a_init_pre_filter *data );
エラーの場合は 1、正常に実行された場合は 0。
entry-point-function 事前フィルタのエントリポイント関数の名前。
data a_init_pre_filter 構造体へのポインタ。
この構造体は外部事前フィルタライブラリに実装される必要があります。また、複数のスレッドで同時に実行できるため再入力可能である必要があります。
この関数の呼び出し元 (データベースサーバ) は、事前フィルタのプロデューサーとして機能する a_text_source オブジェクトへのポインタを提供します。呼び出し元は、入力の文字セットも提供します。
この関数は、外部事前フィルタ (a_text_source 構造体) へのポインタを提供します。この関数は、必要に応じて actual_charset フィールドを変更して、入力 (バイナリでない場合) および出力データの文字セットもネゴシエートします。
desired_charset と actual_charset が同じでない場合、data->is_binary フィールドが 1 でないかぎり、データベースサーバは入力データに対して文字セット変換を実行します。is_binary が 0 の場合には、入力データは actual_charset によって指定された文字セットになります。
data->is_binary
is_binary
actual_charset
文字セットの変換が必要になると、パフォーマンスが低下する原因になる可能性があります。
このエントリポイント関数は、ユーザによって ALTER TEXT CONFIGURATION...PREFILTER EXTERNAL NAME を呼び出して指定されます。