第十三章 以编程方式使用 SQL 网关 - %SQLGatewayConnection 快速参考

%SQLGatewayConnection 快速参考

%SQLGatewayConnection API 概述

%SQLGatewayConnection 提供了可用于管理与外部数据源的连接、检查状态信息以及获取有关 ODBC 共享库的信息的属性和方法。下面列出了本参考中涵盖的方法和属性，按用途组织：

管理连接

%SQLGatewayConnection 提供可用于管理与外部数据源的连接的属性和方法。

• DSN —（%String 属性）要连接的符合 ODBC 的数据源的数据源名称。
• User 用户 —（%String 属性）用于登录数据源的用户名。
• Password 密码 —（%String 属性）关联密码
• ConnectionHandle —（%Binary 属性）与 ODBC 兼容的数据源的当前连接句柄。
• Connect() — 建立与 DSN 的连接。
• GetConnection() — 使用配置设置建立连接以确定 DSN、用户名和密码。
• SetConnectOption() — 调用 ODBC 函数 SQLSetConnectAttr。
• Disconnect() — 关闭连接。

状态及查询方法

%SQLGatewayConnection 的大多数方法都会返回一个状态，应该检查该状态。还可以通过以下属性和方法获取状态信息：

• sqlcode —（%Integer 属性）包含上次调用返回的 SQL 代码（如果有）。
• GatewayStatus —（%Integer 属性）指示上次调用的状态。
• GetLastSQLCode() — 如果此调用不返回 SQL 代码，则返回上次调用的 SQL 代码。
• GatewayStatusGet() — 返回上次调用的错误代码。

以下方法从结果集中获取行：

• FetchRows() — 返回（通过引用）给定连接句柄的指定行数。
• GetOneRow() — 返回（通过引用）给定连接句柄的下一行。

以下方法获取和设置绑定查询参数的值：

• GetParameter() — 返回（通过引用）指定参数的当前值。
• SetParameter() — 设置先前绑定的参数的值。

使用共享库

%SQLGatewayConnection 提供了属性和方法，可以调用这些属性和方法来获取有关 ODBC SQL 网关使用的共享库的信息。

• DLLHandle —（%Binary 属性）当前使用的共享库的句柄。这是在连接时设置的。
• DLLName —（%String 属性）当前使用的共享库的名称。这是在连接时设置的。
• GetGTWVersion() — 返回共享库的当前版本。
• GetUV() —（通过引用）返回共享库是否构建为 Unicode。请注意，此方法始终返回 $$$OK 状态。
• UnloadDLL() — 从进程内存中卸载共享库。