一致性
推出版本:ODBC 3.81 标准合规:ODBC
总结
SQLSetDriverConnectInfo 用于将 连接字符串 设置为应用程序的 SQLDriverConnect 调用的 connection info 令牌中。
Syntax
SQLRETURN SQLSetDriverConnectInfo(
SQLHDBC_INFO_TOKEN hDbcInfoToken,
WCHAR * InConnectionString,
SQLSMALLINT StringLength1 );
Arguments
令牌句柄
[输入]令牌地址。
InConnectionString
[输入]完整的 连接字符串(参见 SQLDriverConnect 中“注释”中的语法)、部分 连接字符串,或空字符串。
StringLength1
[输入]*InConnectionString 的长度,如果字符串是 Unicode,则以字符为单位;如果字符串是 ANSI 或 DBCS,则以字节为单位。
Returns
SQL_SUCCESS、SQL_SUCCESS_WITH_INFO、SQL_ERROR 或SQL_INVALID_HANDLE。
诊断
与 SQLDriverConnect 对任何输入验证错误的处理相同,但驱动程序管理器将使用 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 驱动。