版本:latest

SQLAllocStmt

功能描述

分配语句句柄,其功能可被SQLAllocHandle函数替代。

原型

c
SQLRETURN SQLAllocStmt(SQLHDBC     ConnectionHandle,    
                       SQLHSTMT    *StatementHandle);

参数

表 1 SQLAllocStmt参数

关键字

参数说明

ConnectionHandle

一个有效的、已创建的数据库连接句柄。

在调用此函数前,必须已成功调用SQLConnect建立连接。

StatementHandle

指向 SQLHSTMT 类型变量的指针。函数成功后,该变量将存储新分配的语句句柄。

返回值

  • SQL_SUCCESS:表示调用正确。
  • SQL_SUCCESS_WITH_INFO:表示会有一些警告信息。
  • SQL_ERROR:表示分配语句句柄失败。
  • SQL_INVALID_HANDLE:表示输入的连接句柄无效。

注意事项

为了使代码结构更清晰并易于维护,建议使用标准化接口SQLAllocHandle替代SQLAllocStmt分配语句句柄。

示例

参见:示例