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 » Embedded SQL API-Referenz

 

db_init-Funktion

Initialisiert die UltraLite-Laufzeitbibliothek

Syntax
unsigned short db_init(
SQLCA * sqlca 
); 
Rückgabe
  • 0, wenn während der Verarbeitung ein Fehler auftritt (z.B. während der Initialisierung des beständigen Speichers). Der Fehlererror wird in SQLCA gesetzt.

  • Nicht 0, wenn kein Fehler auftritt. Sie können mit der Verwendung der Embedded SQL-Befehle und -Funktionen beginnen.

Bemerkungen

Sie müssen diese Funktion aufrufen, bevor Sie einen weiteren UltraLite-Bibliotheksaufruf oder einen Embedded SQL-Befehl ausführen.

In den meisten Fällen sollten Sie diese Funktion nur einmal aufrufen und die Adresse der globalen Variablen sqlca übergeben (wie in der Header-Datei sqlca.h definiert). Wenn Ihre Anwendung mehrere Ausführungspfade enthält, können Sie mehrere db_init-Aufrufe verwenden, sofern jeder Aufruf einen eigenen sqlca-Zeiger besitzt. Dieser separate SQLCA-Zeiger kann benutzerdefiniert oder auch ein globaler SQLCA-Bereich sein, der mit db_fini freigegeben wurde.

In Anwendungen mit mehreren Threads muss jeder Thread db_init aufrufen, um eigene SQLCA zu erhalten. Nachfolgende Verbindungen und Transaktionen, die diesen SQLCA-Kommunikationsbereich verwenden, müssen mit einem einzigen Thread ausgeführt werden.

Durch die Initialisierung des SQLCA-Bereichs werden auch alle Einstellungen aus zuvor aufgerufenen ULEnable-Funktionen zurückgesetzt. Wenn Sie einen SQLCA-Bereich neu initialisieren, müssen Sie alle von der Anwendung erforderten ULEnable-Funktionen ausführen.

Siehe auch