一致性
推出版本:ODBC 3.81 标准合规:ODBC
总结
SQLSetConnectAttrForDbcInfo 与 SQLSetConnectAttr 相同,但它将属性设置在连接信息令牌上,而非连接句柄上。
Syntax
SQLRETURN SQLSetConnectAttrForDbcInfo(
SQLHDBC_INFO_TOKEN hDbcInfoToken,
SQLINTEGER Attribute,
SQLPOINTER ValuePtr,
SQLINTEGER StringLength );
Arguments
hDbcInfoToken
[输入]令牌地址。
属性
[输入]归属到集合。 有效属性列表是驱动程序特定的,且与 SQLSetConnectAttr 相同。
ValuePtr
[输入]指向 要关联属性的值。 根据 属性值的不同, ValuePtr 可能是 32 位无符号整数值,或指向无终止字符字符串。 注意,如果 Attribute 参数是驱动程序特定的值, ValuePtr 中的值可能是带符号整数。
StringLength
[输入]如果 Attribute 是 ODBC 定义的属性,ValuePtr 指向字符串或二进制缓冲区,则此参数应为 *ValuePtr 的长度。 对于字符字符串数据,该参数应包含字符串中的字节数。
如果 Attribute 是 ODBC 定义的属性,并且 ValuePtr 是整数, 则忽略 StringLength 。
如果 Attribute 是驱动程序定义的属性,则应用程序通过设置 StringLength 参数来指示该属性对驱动程序管理器的性质。 StringLength 可以具有以下值:
如果 ValuePtr 是指向字符串的指针,则 StringLength 是字符串的长度或SQL_NTS。
如果 ValuePtr 是指向二进制缓冲区的指针,则应用程序会将 SQL_LEN_BINARY_ATTR(length) 宏的结果置于 StringLength 中。 这将在 StringLength 中放置负值。
如果 ValuePtr 是指向字符串或二进制字符串以外的值的指针,则 StringLength 应具有值SQL_IS_POINTER。
如果 ValuePtr 包含固定长度值,则 StringLength 会根据需要SQL_IS_INTEGER或SQL_IS_UINTEGER。
Returns
SQL_SUCCESS、SQL_SUCCESS_WITH_INFO、SQL_ERROR 或SQL_INVALID_HANDLE。
诊断
与 SQLSetConnectAttr 相同,只不过驱动程序管理器会使用 SQL_HANDLE_DBC_INFO_TOKEN 的 HandleType 和 hDbcInfoToken 的 Handle。
Remarks
SQLSetConnectAttrForDbcInfo 与 SQLSetConnectAttr 相同,但它将属性设置在连接信息令牌上,而不是连接句柄上。 例如,如果 SQLSetConnectAttr 不识别某个属性, SQLSetConnectAttrForDbcInfo 也应返回该属性的 SQL_ERROR。
每当驱动程序返回SQL_ERROR或SQL_INVALID_HANDLE时,驱动程序应忽略该属性以计算池ID。 此外,驱动程序管理器会从 hDbcInfoToken 获取诊断信息,并通过 SQLConnect 和 SQLDriverConnect 返回SQL_SUCCESS_WITH_INFO给应用程序。 因此,应用程序可以获取关于某些属性无法设置的原因。
应用程序不应直接调用该函数。 支持驱动程序识别连接池的 ODBC 驱动程序必须实现此功能。
包含 sqlspi.h 以开发 ODBC 驱动。