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

1 bei Fehler und 0 bei erfolgreicher Ausführung

Diese Funktion muss in der externen Vorfilterbibliothek implementiert werden und muss eintrittsinvariant sein, da sie für mehrere Threads gleichzeitig ausgeführt werden kann.

Der Aufrufer der Funktion (Datenbankserver) stellt einen Zeiger auf ein a_text_source-Objekt bereit, das als Produzent für den Vorfilter fungiert. Der Aufrufer stellt auch den Zeichensatz der Eingabe bereit.

Diese Funktion stellt einen Zeiger auf den externen Vorfilter bereit (a_text_source-Struktur). Darüber hinaus handelt sie den Zeichensatz der Eingabedaten (wenn diese nicht binär sind) und der Ausgabedaten durch Ändern des actual_charset-Felds aus, falls erforderlich.

Wenn desired_charset und actual_charset nicht identisch sind, führt der Datenbankserver eine Zeichensatzkonvertierung der Eingabedaten durch, es sei denn das Feld data->is_binary hat den Wert 1. Wenn also is_binary 0 ist, liegen die Eingabedaten im durch actual_charset festgelegten Zeichensatz vor.

Beachten Sie, dass erforderliche Zeichensatzkonvertierungen zu einer Verminderung der Performance führen können.

Diese Eintrittspunktfunktion wird vom Benutzer durch Aufruf von ALTER TEXT CONFIGURATION...PREFILTER EXTERNAL NAME angegebenen. Siehe PREFILTER EXTERNAL NAME-Klausel, ALTER TEXT CONFIGURATION-Anweisung.

• a_init_pre_filter-Struktur
• Schnittstelle a_text_source
• PREFILTER EXTERNAL NAME-Klausel, ALTER TEXT CONFIGURATION-Anweisung