SQLSetConnectInfo 函数

一致性
推出版本:ODBC 3.81 标准合规:ODBC

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

Syntax

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

Arguments

令牌句柄
[输入]令牌地址。

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

NameLength1
[输入]*ServerName 字符长度。

UserName
[输入]用户标识。

NameLength2
[输入]*用户名 字符数长度。

Authentication
[输入]认证字符串(通常是密码)。

NameLength3
[输入]*以字符为单位的认证 时长。

Returns

SQL_SUCCESS、SQL_SUCCESS_WITH_INFO、SQL_ERROR 或SQL_INVALID_HANDLE。

诊断

输入验证错误与 SQLConnect 相同,但驱动管理器将使用 SQL_HANDLE_DBC_INFO_TOKEN 的 HandleType 和 hDbcInfoToken 的 Handle。

Remarks

每当驱动程序返回SQL_ERROR或 SQL_INVALID_HANDLE,驱动程序管理器会将错误返回给应用程序(通过 SQLConnect 或 SQLDriverConnect 进行)。

每当驱动程序返回SQL_SUCCESS_WITH_INFO时,驱动程序管理器会从 hDbcInfoToken 获取诊断信息,并通过 SQLConnect 和 SQLDriverConnect 返回SQL_SUCCESS_WITH_INFO给应用程序。

应用程序不应直接调用该函数。 支持驱动程序识别连接池的 ODBC 驱动程序必须实现此功能。

包含 sqlspi.h 以开发 ODBC 驱动。