Registriert eine Funktion, die aufgerufen werden soll, wenn die Synchronisation über die Anweisung SQL SYNCHRONIZE ausgeführt wird. Wenn die Callback-Funktion einer Synchronisation in UltraLite definiert und registriert wird, wird bei jedem Ausführen einer SYNCHRONIZE-Anweisung der Verarbeitungsfortschritt dieser Synchronisation an die Callback-Funktion übergeben. Wenn kein Callback registriert wurde, werden die Informationen über den Verarbeitungsfortschritt unterdrückt.
void ULRegisterSynchronizationCallback ( SQLCA * sqlca, ul_synch_observer_fn callback, ul_void * user_data );
sqlca Ein Zeiger auf den SQL-Kommunikationsbereich (SQLCA-Bereich).
Verwenden Sie in der C++-API die Methode Sqlca.GetCA.
callback Der Name Ihrer Callback-Funktion.
Ein Callback-Wert UL_NULL deaktiviert alle vorher registrierten Callback-Funktionen.
user_data Eine Alternative zu globalen Variablen, um Kontextinformationen global verfügbar zu machen. Dies ist erforderlich, da Sie die Callback-Funktion von allen Positionen in Ihrer Anwendung aus aufrufen können. UltraLite ändert die übergebenen Daten nicht, sondern übergibt sie einfach an Ihre Callback-Funktion, wenn diese aufgerufen wird.
Sie können jeden beliebigen Datentyp deklarieren und in Ihrer Callback-Funktion in den richtigen Typ umwandeln. Sie können beispeilsweise eine Zeile der folgenden Art in Ihre Callback-Funktion aufnehmen:
MyContextType * context = (MyContextType *) user_data; |
| Kommentieren Sie diese Seite in DocCommentXchange. Senden Sie uns Feedback über diese Seite via E-Mail. |
Copyright © 2009, iAnywhere Solutions, Inc. - SQL Anywhere 11.0.1 |