文章目录
第十三章 以编程方式使用 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()— 从进程内存中卸载共享库。