Posted on 2009-06-22 15:12
Prayer 閱讀(3023)
評論(0) 編輯 收藏 引用 所屬分類:
DB2CLI
用途
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