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 を呼び出して指定されます。