文章目录
- [第十三章 以编程方式使用 SQL 网关 - %SQLGatewayConnection 快速参考](#第十三章 以编程方式使用 SQL 网关 - %SQLGatewayConnection 快速参考)
- [%SQLGatewayConnection 快速参考](#%SQLGatewayConnection 快速参考)
第十三章 以编程方式使用 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()--- 从进程内存中卸载共享库。