Fonction SQLConnectEx ()

Vous utilisez la fonction SQLConnectEx() dans un InTouch QuickScript pour vous connecter à la base de données spécifiée par l'argument ConnectString, lorsque vous utilisez les informations d'identification de type « Nom d'utilisateur et mot de passe » pour l'authentification SQL.

SQLConnectEx() renvoie une valeur à l'argument ConnectionID qui est utilisé comme un paramètre dans toutes les fonctions SQL suivantes. Vous devez avoir une liste de liens définie dans le dossier d'application avant d'utiliser la fonction SQLConnectEx dans un script.

Catégorie

SQL

Syntaxe

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

Arguments

ConnectionID

Nom d'une variable d'entier de mémoire contenant le numéro (ID) attribué par la fonction SQLConnectEx() à chaque connexion à la base de données.

ConnectString

Chaîne qui identifie la base de données et toute information de connexion supplémentaire utilisée dans la fonction SQLConnectEx().

Nom des informations d’identification

Nom des informations d'identification stockées dans le gestionnaire d'informations d'identification. Pour les applications InTouch autonomes, les informations d'identification sont récupérées à partir du Gestionnaire d'applications. Pour les applications InTouch managées, les informations d'identification sont récupérées à partir du gestionnaire d'informations d'identification de l'Application Server.

Remarques

Vous devez avoir une liste de liens (un fichier SQL.DEF) dans le dossier d'applications. Sans cette liste, la fonction ne fonctionnera pas.

Si SQLTrace=1 est défini dans la section [InTouch] du fichier win.ini, chaque exécution réussie de SQLConnectEx enregistre les informations de version de l'ADO, du fournisseur et du système de base de données dans Log Viewer.

Exemples

Cet exemple établit une connexion au gestionnaire IBM OS/2 et à la base de données EXEMPLE :

[ResultCode=]SQLConnectEx(ConnectionID,"DSN=OS2DM;
DB=SAMPLE");

Cette fonction renvoie une valeur dans la variable ConnectionID, utilisée comme paramètre dans toutes les fonctions SQL suivantes.

"DSN=data source name[;attribute=value
[;attribute=value]...] »