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。