SQLCONNECT() 函 数

建立一个指向数据源的连接

语 法

SQLCONNECT([ DataSourceName , cUserID , cPassword | cConnectionName ])

返 值 类 型数值型 参 数 描 述

DataSourceName

数 据 源 的 名 称 该 名 称 和 ODBC.INI 文 件 中 的 定 义 相 同

cUserID

向 数 据 源 注 册 的 用 户 标 识

cPassword

数 据 源 的 密 码

cConnectionName

用 CREATE CONNECTION 创 建 的 命 名 连 接

说 明

如果成功地连接到数据源上 SQLCONNECT ( ) 函数返回一个正的 非零的句柄 应该将这个句柄存入变量中 在随后需要连接句柄的函数调用中 就能使用该变量 如果不能连接 SQLCONNECT( ) 返回 -2

如果不带任何附加参数发出 SQLCONNEC T( ) 那么将显示选择连接或数据源对话框 供您选择数据源

注 意 为 了 支 持 M icrosoft Transaction Server 的 SQL pass - through 功 能 必 须

废 止 ODBC 登 录 对 话 框 使 用 SQLSETPROP( cConnectionHandle ,

'D ispLogin', 3) 可 以 废 止 ODBC 登 录 对 话 框 cConnectionHandle 是SQLCONNECT 返 回 的 连 接 句 柄 也 可 以 在 连 接 设 计 器 中 废 止ODBC 登 录 对 话 框

示 例

下面的示例假设有名称为 M yFoxSQLNT 的 ODBC 数据源 并且此数据源的用户 ID

是 “ sa .” 发出 SQLCONNECT( ) 命令 并将返回值保存到变量 gnConnHandle 中

STORE SQLCONNECT( 'MyFoxSQLNT', 'sa ') TO gnConnHandle IF gnConnHandle <= 0

= MESSAGEBOX('Cannot make connection', 16, 'SQL Connect Error') ELSE

= MESSAGEBOX('Connection made', 48, 'SQL Connect Message)

= SQLDISCONNECT(gnConnHandle) ENDIF

请 参 阅

AERROR ( ) , CREATE CONNECTION , SQLDISCONNECT( ) ,

SQLGETPROP( ) , SQLEXEC( ) , SQLSETPROP( ) , SQLSTRINGCONNECT( )