SQLSetDriverConnectInfo 函数

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