Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.1 (Deutsch) » UltraLite - C- und C++-Programmierung » API-Referenz » UltraLite C/C++ - Gemeinsame API-Referenz

 

Callback-Funktion für ULRegisterErrorCallback

Verarbeitet Fehler, die die UltraLite-Runtime-Bibliothek an Ihre Anwendung meldet

Eine Beschreibung der Fehlerbehandlung unter Einsatz dieser Technik finden Sie unter ULRegisterErrorCallback-Funktion.

Syntax
ul_error_action UL_GENNED_FN_MOD error-callback-function (
SQLCA * sqlca,
ul_void * user_data,
ul_char * buffer
);
Parameter
  • error-callback-function   Der Name Ihrer Funktion. Sie müssen den Namen an ULRegisterErrorCallback übergeben.

  • sqlca   Ein Zeiger auf den SQL-Kommunikationsbereich (SQLCA).

    Der SQLCA enthält den SQL-Code in sqlca->sqlcode. Etwaige Fehlerparameter wurden bereits aus dem SQLCA abgerufen und in buffer gespeichert.

    Dieser sqlca-Zeiger zeigt nicht notwendigerweise auf den SQLCA in Ihrer Anwendung und kann nicht für einen Callback an UltraLite verwendet werden. Er wird nur verwendet, um den SQL-Code an die Callback-Funktion zu übermitteln.

    In der C++-Komponente benutzen Sie die Methode Sqlca.GetCA.

  • user_data   Die Benutzerdaten, die an ULRegisterErrorCallback übergeben werden. UltraLite ändert diese Daten nicht. Da die Callback-Funktion überall in Ihrer Anwendung signalisiert werden kann, ist das Argument user_data eine Alternative zur Erstellung einer globalen Variablen.

  • buffer   Der Puffer, der bei der Registrierung der Callback-Funktion registriert wurde. UltraLite füllt den Puffer mit einer Zeichenfolge, die Substitutionsparameter für die Fehlermeldung enthält. Um UltraLite so klein wie möglich zu halten, werden von UltraLite selbst keinerlei Fehlermeldungen übergeben. Die Substitutionsparameter hängen von dem jeweiligen Fehler ab. Weitere Hinweise zu Fehlerparametern für SQL-Fehler finden Sie unter SQL Anywhere - Fehlermeldungen.

Rückgabewert

Gibt eine der folgenden Aktionen zurück:

  • UL_ERROR_ACTION_CANCEL   Vorgang abbrechen, der zu dem Fehler geführt hat.

  • UL_ERROR_ACTION_CONTINUE   Fortsetzen und den Vorgang ignorieren, der zu dem Fehler geführt hat.

  • UL_ERROR_ACTION_DEFAULT   So verhalten, als ob es keinen Fehler-Callback gibt.

  • UL_ERROR_ACTION_TRY_AGAIN   Vorgang wiederholen, der zu dem Fehler geführt hat

Siehe auch