一致性
推出版本: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 驱动。