通过

SQLSetConnectInfo 函数

  • 项目

一致性
引入的版本：ODBC 3.81 标准符合性：ODBC

摘要
SQLSetConnectInfo 用于将数据源、用户 ID 和密码设置为应用程序的 SQLConnect 调用的连接信息令牌中。

语法

  
SQLRETURN  SQLSetConnectInfo(  
                SQLHDBC_INFO_TOKEN   TokenHandle,  
                WCHAR *              ServerName,  
                SQLSMALLINT          NameLength1,  
                WCHAR *              UserName,  
                SQLSMALLINT          NameLength2,  
                WCHAR *              Authentication,  
                SQLSMALLINT          NameLength3 );

参数

TokenHandle
[输入]令牌句柄。

ServerName
[输入]数据源名称。 数据可能位于程序所在的同一台计算机上，或者位于网络上的某个位置的另一台计算机上。 有关应用程序如何选择数据源的信息，请参阅 选择数据源或驱动程序。

NameLength1
[输入]*ServerName 的长度（以字符为单位）。

UserName
[输入]用户标识符。

NameLength2
[输入]*UserName 的长度（以字符为单位）。

身份验证
[输入]身份验证字符串通常 (密码) 。

NameLength3
[输入]*身份验证 的长度（以字符为单位）。

返回

SQL_SUCCESS、SQL_SUCCESS_WITH_INFO、SQL_ERROR 或 SQL_INVALID_HANDLE。

诊断

与 SQLConnect 输入验证错误相同，只不过驱动程序管理器将使用 SQL_HANDLE_DBC_INFO_TOKEN 的 HandleType 和 hDbcInfoToken 的句柄。

备注

每当驱动程序返回SQL_ERROR或SQL_INVALID_HANDLE时，驱动程序管理器会将错误返回到 SQLConnect 或 SQLDriverConnect) 中的应用程序 (。

每当驱动程序返回SQL_SUCCESS_WITH_INFO时，驱动程序管理器将从 hDbcInfoToken 获取诊断信息，并将SQL_SUCCESS_WITH_INFO返回到 SQLConnect 和 SQLDriverConnect 中的应用程序。

应用程序不应直接调用此函数。 支持驱动程序感知连接池的 ODBC 驱动程序必须实现此函数。

包括用于 ODBC 驱动程序开发的 sqlspi.h。

另请参阅

开发 ODBC 驱动程序
识别驱动程序的连接池
在 ODBC 驱动程序中开发连接池感知