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 的 HandleType 和 hDbcInfoToken 的句柄。
备注
每当驱动程序返回SQL_ERROR或SQL_INVALID_HANDLE时,驱动程序管理器会将错误返回到 SQLConnect 或 SQLDriverConnect) 中的应用程序 (。
每当驱动程序返回SQL_SUCCESS_WITH_INFO时,驱动程序管理器将从 hDbcInfoToken 获取诊断信息,并将SQL_SUCCESS_WITH_INFO返回到 SQLConnect 和 SQLDriverConnect 中的应用程序。
应用程序不应直接调用此函数。 支持驱动程序感知连接池的 ODBC 驱动程序必须实现此函数。
包括用于 ODBC 驱动程序开发的 sqlspi.h。