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

 

 

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