文档中心

SQLConnect函数 ​

功能 ​

连接客户端和服务端，生成会话。

函数原型 ​

c
SQLRETURN SQLConnect(
      SQLHDBC 		ConnectionHandle,
      SQLCHAR * 	ServerName,
      SQLSMALLINT 	NameLength1,
      SQLCHAR * 	UserName,
      SQLSMALLINT 	NameLength2,
      SQLCHAR * 	Authentication,
      SQLSMALLINT 	NameLength3);

参数解释 ​

  • ConnectionHandle：连接句柄。
  • ServerName：ODBC 配置的DSN，在第三章有配置 DSN 的介绍。
  • NameLength1：DSN 名的长度以字节为单位，可以选填默认值SQL_NTS，可根据DSN名长度自动匹配长度。
  • UserName：用户名，为字符串格式，连接数据库的身份权限标识。
  • NameLength2：以字节为单位描述用户名长度，可选填默认值SQL_NTS根据用户名长度自动匹配长度。
  • Authentication：用户口令字符串格式，连接数据库的用户匹配的口令。
  • NameLength3：以字节为单位描述用户口令长度，可选填默认值SQL_NTS根据用户口令长度自动匹配长度。

返回值 ​

成功时返回SQL_SUCCESS。