一致性
推出版本:ODBC 3.8 标准合规性:ODBC
总结
如果池中没有连接可重复使用,SQLPoolConnect 用于创建新的连接。
Syntax
SQLRETURN SQLPoolConnect(
SQLHDBC hDbc,
SQLHDBC_INFO_TOKEN hDbcInfoToken,
WCHAR * wszOutConnectString,
SQLSMALLINT cchConnectStringBuffer,
SQLSMALLINT * cchConnectStringLen );
Arguments
hDbc
[输入]连接手柄。
hDbcInfoToken
[输入]新应用连接请求的令牌句柄。
wszOutConnectString
[输出]指向已完成连接字符串的缓冲区。 成功连接到目标数据源后,该缓冲区包含已完成的连接字符串。 应用程序应为该缓冲区分配至少1024个字符。
如果 wszOutConnectString 是 NULL,cchConnectStringLen 仍然会返回 wszOutConnectString 指向的缓冲区中可返回的字符总数(不含字符数据的空终止字符)。
cchConnectStringBuffer
[输入]*wszOutConnectString 缓冲区的长度,以字符为单位。
cchConnectStringLen
[输出]指向一个缓冲区,返回*wszOutConnectString中可返回的字符总数(不含空终止字符)。 如果可返回的字符数大于或等于 cchConnectStringBuffer,则 *wszOutConnectString 中已完成的 连接字符串 会被截断为 cchConnectStringBuffer 减去空终止字符长度。
Returns
SQL_SUCCESS、SQL_SUCCESS_WITH_INFO、SQL_ERROR或SQL_INVALID_HANDLE。
诊断
类似于 SQLDriverConnect 用于任何输入验证错误,但驱动程序管理器会使用 SQL_HANDLE_DBC_INFO_TOKEN 的 HandleType 和 hDbcInfoToken 的 Handle。
Remarks
驱动程序管理器保证 hDbc 和 hDbcInfoToken 的父 HENV 句柄是相同的。
与 SQLDriverConnect 不同,它没有 DriverCompletion 参数来提示用户输入连接信息。 在池化场景中不允许提示对话。
应用程序不应直接调用该函数。 支持驱动程序识别连接池的 ODBC 驱动程序必须实现此功能。
每当驱动程序返回SQL_ERROR或 SQL_INVALID_HANDLE,驱动程序管理器会将错误返回给应用程序(通过 SQLConnect 或 SQLDriverConnect 进行)。
每当驱动程序返回SQL_SUCCESS_WITH_INFO时,驱动程序管理器会从 hDbcInfoToken 获取诊断信息,并通过 SQLConnect 和 SQLDriverConnect 返回SQL_SUCCESS_WITH_INFO给应用程序。
当应用程序使用 SQLConnect 时, wszOutConnectString 将是一个 NULL 缓冲区(最后三个参数均设置为 NULL, 0, NULL)。 否则,驱动程序必须返回输出连接字符串,该字符串将返回到应用程序的SQLDriverConnect Function调用中。
包含 sqlspi.h 以开发 ODBC 驱动。