extern "C" a_sql_uint32 ( SQL_CALLBACK *entry-point-function )( a_init_pre_filter *data );

执行出错时返回 1，成功时返回 0。

该函数必须在外部前置过滤器库中实现，并且需要可重入，因为它可以在多个线程中同时执行。

函数调用方（数据库服务器）提供指向将用作前置过滤器创建器的 a_text_source 对象的指针。调用方还提供输入的字符集。

该函数提供指向外部前置过滤器（a_text_source 结构）的指针。如果需要，它还可以通过更改 actual_charset 字段协商输入（如果不是二进制）和输出数据的字符集。

如果 desired_charset 和 actual_charset 不同，数据库服务器将对输入数据执行字符集转换，除非 [data->is_binary] 字段为 1。如果 [is_binary] 是 0，则输入数据将使用由 [actual_charset] 指定的字符集。

要求字符集转换可能会导致性能降级。

入口点函数由用户通过调用 ALTER TEXT CONFIGURATION...PREFILTER EXTERNAL NAME 指定。

• a_init_pre_filter 结构
• a_init_pre_filter 结构
• a_text_source interface
• PREFILTER EXTERNAL NAME 子句，ALTER TEXT CONFIGURATION 语句