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 — 分配语句句柄

 

 

---

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