SQLConnectEx ()-Funktion

Mit der SQLConnectEx()-Funktion in einem InTouch-QuickScript verbinden Sie sich mit der durch das Argument ConnectString angegebenen Datenbank, wenn Sie Anmeldeinformationen vom Typ „Benutzername und sKennwort“ zur SQL-Authentifizierung verwenden.

SQLConnectEx() gibt einen Wert an das Argument ConnectionID zurück, die als Parameter für alle nachfolgenden SQL-Funktionen verwendet wird. Bevor Sie die SQLConnectEx-Funktion in einem Skript verwenden, müssen Sie eine Bindeliste im Projektordner definieren.

Kategorie

SQL

Syntax

[ResultCode=]SQLConnectEx(ConnectionID, "ConnectString", "Credential Name");

Argumente

VerbindungsID

Name einer Memory-Integer-Variable, die die Nummer (ID) enthält, die von der Funktion SQLConnectEx() jeder Datenbankverbindung zugewiesen wird.

Verbindungszeichenfolge

Zeichenfolge, welche die Datenbank und alle zusätzlichen Anmeldeinformationen bezeichnet, die in der SQLConnectEx()-Funktion verwendet werden.

Name der Anmeldeinformationen

Name der im Anmeldeinformations-Manager gespeicherten Anmeldeinformation. Bei eigenständigen InTouch-Projekten werden die Anmeldeinformationen vom Projekt-Manager abgerufen. Bei verwalteten InTouch-Projekten werden die Anmeldeinformationen vom Anmeldeinformations-Manager des Application Server abgerufen.

Anmerkungen

Im Projektordner muss eine Bindeliste (in der Datei SQL.DEF) gespeichert sein. Anderenfalls versagt diese Funktion den Dienst.

Ist SQLTrace=1 im [InTouch]-Abschnitt der win.ini-Datei definiert, protokolliert jede erfolgreiche Ausführung von SQLConnectEx Versionsinformationen für ADO, die Quelle und das Datenbanksystem im Log Viewer.

Beispiele

Mit der folgenden Anweisung stellen Sie eine Verbindung zum IBM OS/2 Datenbankmanager und zur Datenbank MUSTER her:

[ErgebnisCode=]SQLConnectEx(VerbindungsID,"DSN=OS2DM;
DB=MUSTER");

Die Funktion gibt einen Wert an die Variable ConnectionID zurück, die als Parameter für alle nachfolgenden SQL-Funktionen verwendet wird.

"DSN=Datenquellenname[;Attribut=Wert
[;Attribut=Wert]...]"