DB2 通用数据库 iSeries 版 SQL 调用层接口(ODBC)[转]

SQLAllocHandle — 分配句柄

 

用途

SQLAllocHandle() 分配任何类型的句柄。

语法

SQLRETURN SQLAllocHandle (SQLSMALLINT htype, SQLINTEGER ihandle, SQLINTEGER *handle); 

函数自变量

表 10. SQLAllocHandle 自变量

数据类型 自变量 使用 描述
SQLSMALLINT htype 输入 要分配的句柄的类型。必须是 SQL_HANDLE_ENV、SQL_HANDLE_DBC、SQL_HANDLE_DESC 或 SQL_HANDLE_STMT。
SQLINTEGER ihandle 输入 描述在其中分配新句柄的上下文的句柄;然而,如果 htype 是 SQL_HANDLE_ENV,则这是 SQL_NULL_HANDLE。
SQLINTEGER * handle 输出 指向句柄的指针

用法

此函数组合了函数 SQLAllocEnv()、SQLAllocConnect() 和 SQLAllocStmt()。

如果 htype 是 SQL_HANDLE_ENV,则 ihandle 必须是 SQL_NULL_HANDLE。如果 htype 是 SQL_HANDLE_DBC,则 ihandle 必须是有效的环境句柄。如果 htype 是 SQL_HANDLE_DESC 或 SQL_HANDLE_STMT,则 ihandle 必须是有效的连接句柄。

返回码

  • SQL_SUCCESS
  • SQL_ERROR
  • SQL_INVALID_HANDLE

诊断

如果自变量 handle 是空指针,则返回 SQL_ERROR。

表 11. SQLAllocHandle SQLSTATE

SQLSTATE 描述 说明
58004 系统错误 不可恢复的系统错误。
HY014 句柄太多 已分配了最大数目的句柄

参考

  • SQLAllocConnect — 分配连接句柄
  • SQLAllocEnv — 分配环境句柄
  • SQLAllocStmt — 分配语句句柄

 

 

[  上一页 | 下一页 | 目录 | 索引 ]

你可能感兴趣的:(DB2 通用数据库 iSeries 版 SQL 调用层接口(ODBC)[转])