SQLConnectEx() 函数

在使用类型为“用户名和密码”的凭据进行 SQL 身份验证时，可以使用 InTouch QuickScript 中的 SQLConnectEx() 函数连接到由 ConnectString 参数指定的数据库。

SQLConnectEx() 返回一个值给 ConnectionID 参数，后续的所有 SQL 函数都将它用作参数。在脚本中使用 SQLConnectEx 函数之前，必须先在应用程序文件夹中定义“绑定列表”。

类别

SQL

语法

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

参数

ConnectionID

内存整型标记的名称，用于存放 SQLConnectEx() 函数指定给每个数据库连接的编号 (ID)。

ConnectString

确定 SQLConnectEx() 函数中使用的数据库以及任何附加登录信息的字符串。

凭证名称

凭据管理器中存储的凭据的名称。对于独立 InTouch 应用程序，从“应用程序管理器”中检索凭据。对于托管 InTouch 应用程序，从 Application Server 的“凭据管理器”中检索凭据。

附注

应用程序文件夹中必须存在“绑定列表”（SQL.DEF 文件）。否则此函数无法正常工作。

如果在 win.ini 文件的 [InTouch] 部分定义了 SQLTrace=1，则每次成功执行 SQLConnectEx 时，都会将 ADO、供应器以及数据库系统的版本信息记录到 Log Viewer。

示例

下面的语句连接到 IBM OS/2 Database Manager 与名称为 SAMPLE 的数据库：

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

此函数返回一个值给 ConnectionID 变量，所有后续的“SQL 函数”都要将此变量用作参数。

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