SQLDISCONNECT() 函 数

终止与数据源的连接

语 法

SQLDISCONNECT( nConnectionHandle )

返 值 类 型

数值型

参 数 描 述

nConnectionHandle

由 SQLCONNECT ( ) 返 回 并 指 向 数 据 源 的 连 接 句 柄 nConnectionHandle 为

0 将 终 止 所 有 活 动 的 连 接

说 明

如果成功终止了连接 SQLDISCONNECT ( )返回 1 如果发生连接级错误 返回 -1 如果发生环境级错误 返回 -2

SQLDISCONNECT ( ) 终止一个指向数据源的连接 在建立连接时 必须提供

SQLCONNECT( ) 返回的连接句柄

注 意 在异步函数序列中或事务处理期间 如果执行 SQLDISCONNECT( ) 函数

SQLDISCONNECT( ) 将产生错误

示 例

下面的示例假定一个名为 M yFoxSQLNT 的 ODBC 数据可用 该数据源的用户标识是

sa 发出 SQLCONNECT ( ) 其返回值存入名为 gnConnHandle 的变量

如果成功地连接到数据源上 SQLCONNECT ( ) 返回一个正数 并显示一个对话框再发出 SQLDISCONNECT( ) 解除和数据库的连接 如果不能连接到数据源上SQLCONNECT( ) 返回一个负数 并显示一条信息

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 ( ) , SQLCONNECT( ) , SQLSTRINGCONNECT( )