用途

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