SQLSetDriverConnectInfo 函数

一致性
引入的版本:ODBC 3.81 标准符合性:ODBC

摘要
SQLSetDriverConnectInfo 用于将连接字符串设置为应用程序的 SQLDriverConnect 调用的连接信息令牌。

语法

  
SQLRETURN SQLSetDriverConnectInfo(  
                SQLHDBC_INFO_TOKEN   hDbcInfoToken,  
                WCHAR *              InConnectionString,  
                SQLSMALLINT          StringLength1 );  

参数

TokenHandle
[输入]令牌句柄。

InConnectionString
[输入]完整的连接字符串 (SQLDriverConnect) 、部分连接字符串或空字符串的“注释”中查看语法。

StringLength1
[输入]*InConnectionString 的长度,如果字符串为 Unicode,则以字符为单位;如果字符串为 ANSI 或 DBCS,则以字节为单位。

返回

SQL_SUCCESS、SQL_SUCCESS_WITH_INFO、SQL_ERROR 或 SQL_INVALID_HANDLE。

诊断

与与任何输入验证错误相关的 SQLDriverConnect 相同,只不过驱动程序管理器将使用 SQL_HANDLE_DBC_INFO_TOKEN 的 HandleTypehDbcInfoToken句柄

备注

每当驱动程序返回SQL_ERROR或SQL_INVALID_HANDLE时,驱动程序管理器会将错误返回到 SQLConnectSQLDriverConnect) 中的应用程序 (。

每当驱动程序返回SQL_SUCCESS_WITH_INFO时,驱动程序管理器将从 hDbcInfoToken 获取诊断信息,并将SQL_SUCCESS_WITH_INFO返回到 SQLConnectSQLDriverConnect 中的应用程序。

应用程序不应直接调用此函数。 支持驱动程序感知连接池的 ODBC 驱动程序必须实现此函数。

包括用于 ODBC 驱动程序开发的 sqlspi.h。

另请参阅

开发 ODBC 驱动程序
识别驱动程序的连接池
在 ODBC 驱动程序中开发连接池感知