符合性
版本引入了: ODBC 1.0 标准符合性: ISO 92
摘要
SQLParamData使用连同SQLPutData提供参数数据在语句执行时,且SQLGetData检索流式处理的输出参数数据。
语法
SQLRETURN SQLParamData(
SQLHSTMT StatementHandle,
SQLPOINTER * ValuePtrPtr);
参数
StatementHandle
[输入]语句句柄。
ValuePtrPtr
[输出]指向要返回的地址在其中的缓冲区ParameterValuePtr中指定的缓冲区SQLBindParameter (适用于参数数据) 或地址TargetValuePtr中指定的缓冲区SQLBindCol (适用于列数据),如 SQL_DESC_DATA_PTR 描述符记录字段中包含。
返回
SQL_SUCCESS、 SQL_SUCCESS_WITH_INFO、 SQL_NEED_DATA、 SQL_NO_DATA、 SQL_STILL_EXECUTING、 SQL_ERROR、 SQL_INVALID_HANDLE 或 SQL_PARAM_DATA_AVAILABLE。
诊断
当SQLParamData返回 SQL_ERROR 或 SQL_SUCCESS_WITH_INFO,关联的 SQLSTATE 值可以通过调用来获取SQLGetDiagRec与HandleType的 SQL_HANDLE_STMT 和一个处理的StatementHandle。 下表列出了通常由返回的 SQLSTATE 值SQLParamData ,并解释了此函数; 每个上下文中的表示法"(数据挖掘)"之前 SQLSTATEs 返回由驱动程序管理器的说明。 与每个 SQLSTATE 值关联的返回代码是 SQL_ERROR,除非另有说明。
| SQLSTATE | 错误 | Description |
|---|---|---|
| 01000 | 常规警告 | 特定于驱动程序的信息性消息。 (函数返回 SQL_SUCCESS_WITH_INFO。) |
| 07006 | 受限制的数据类型属性冲突 | 标识的数据值ValueType中的参数SQLBindParameter无法为数据类型由标识转换绑定的参数为ParameterType中的参数SQLBindParameter。 参数绑定为 SQL_PARAM_INPUT_OUTPUT 或 SQL_PARAM_OUTPUT 不无法转换为标识的数据类型返回的数据值ValueType中的参数SQLBindParameter。 (如果无法转换为一个或多个行的数据值,但没有成功返回一个或多个行,此函数返回 SQL_SUCCESS_WITH_INFO。) |
| 08S01 | 通讯链接失败 | 该驱动程序和驱动程序已连接到数据源之间的通信链接失败之前函数已完成处理。 |
| 22026 | 字符串数据,长度不匹配 | 中的 SQL_NEED_LONG_DATA_LEN 信息类型SQLGetInfo "Y",不是指定了较少的数据已发送长参数 (数据类型为 SQL_LONGVARCHAR、 SQL_LONGVARBINARY、 或的长整型数据源特定于数据类型)与StrLen_or_IndPtr中的参数SQLBindParameter。 中的 SQL_NEED_LONG_DATA_LEN 信息类型SQLGetInfo为"Y",而且比中指定了较少的数据已发送长列 (数据类型为 SQL_LONGVARCHAR、 SQL_LONGVARBINARY、 或的长整型数据源特定于数据类型)对应于已添加或使用更新的数据行中的列长度的缓冲区SQLBulkOperations或更新,它SQLSetPos。 |
| 40001 | 序列化失败 | 事务已回滚,由于其他事务与资源死锁。 |
| 40003 | 语句完成情况未知 | 此函数中,在执行期间失败关联的连接,无法确定事务的状态。 |
| HY000 | 常规错误 | 有关其中没有任何特定的 SQLSTATE 和为其定义任何特定于实现的 SQLSTATE 出错。 返回的错误消息SQLGetDiagRec中 *MessageText缓冲区描述错误以及其原因。 |
| HY001 | 内存分配错误 | 该驱动程序无法分配支持执行或完成该函数所需的内存。 |
| HY008 | 操作已取消 | 异步处理的已启用StatementHandle。 调用该函数,和之前执行完毕SQLCancel或SQLCancelHandle上调用了StatementHandle; 然后在再次调用该函数StatementHandle。 调用该函数,和之前执行完毕SQLCancel或SQLCancelHandle上调用了StatementHandle来自不同线程中多线程应用程序。 |
| HY010 | 函数序列错误 | (DM) 以前的函数调用不是调用SQLExecDirect, SQLExecute, SQLBulkOperations,或者SQLSetPos其中返回代码为 SQL_NEED_DATA,或上一个函数调用已调用SQLPutData。 上一个函数调用已调用SQLParamData。 (DM) 为与之关联的连接句柄调用以异步方式执行的函数StatementHandle。 此异步函数仍在执行时SQLParamData调用函数。 (DM) 的调用以异步方式执行的函数 (不是此类似) StatementHandle和仍在执行时调用此函数。 SQLExecute, SQLExecDirect, SQLBulkOperations,或SQLSetPos曾为StatementHandle和返回的 SQL_NEED_DATA。 SQLCancel数据已发送的所有执行时数据参数或列之前调用。 |
| HY013 | 内存管理错误 | 无法处理函数调用,因为基础内存对象无法访问,可能是由于内存不足的情况。 |
| HY117 | 由于未知的事务状态而挂起连接。 仅断开连接,并允许使用只读的函数。 | (DM) 有关挂起状态的详细信息,请参阅SQLEndTran 函数。 |
| HYT01 | 连接超时时间已到 | 连接超时期限过期之前的数据源响应此请求。 通过设置连接超时期SQLSetConnectAttr,SQL_ATTR_CONNECTION_TIMEOUT。 |
| IM001 | 驱动程序不支持此函数 | (DM) 对应的驱动程序StatementHandle不支持该函数。 |
| IM017 | 轮询异步通知模式中禁用 | 只要使用通知模型,将禁用轮询。 |
| IM018 | SQLCompleteAsync尚未调用以完成此句柄上以前的异步操作。 | 如果句柄上的上一个函数调用返回 SQL_STILL_EXECUTING,如果启用通知模式,则SQLCompleteAsync必须要对其进行后期处理并完成该操作的句柄上调用。 |
如果SQLParamData调用时发送参数数据中的 SQL 语句,它可以返回任何可由函数调用以执行该语句返回的 SQLSTATE (SQLExecute或SQLExecDirect)。 如果发送数据的列时调用正在进行更新或添加具有SQLBulkOperations或使用更新SQLSetPos,它可以返回任何可由返回的 SQLSTATE SQLBulkOperations或SQLSetPos。
注释
SQLParamData可以调用来提供这两种用法的数据执行时数据: 将对的调用中使用的参数数据SQLExecute或SQLExecDirect,或将列数据时使用更新或通过调用添加行SQLBulkOperations或通过调用更新SQLSetPos。 在执行时, SQLParamData返回到应用程序驱动程序需要使用哪些数据的指示器。
当应用程序调用SQLExecute, SQLExecDirect, SQLBulkOperations,或者SQLSetPos,驱动程序返回 SQL_NEED_如果它需要执行时数据的数据的数据。 随后,应用程序调用SQLParamData来确定要发送的数据。 如果该驱动程序需要参数的数据,驱动程序将返回在 *ValuePtrPtr输出缓冲区的应用程序放在行集的缓冲区中的值。 应用程序可以使用此值以确定驱动程序正在请求的参数数据。 如果该驱动程序需要列数据,驱动程序将返回在 *ValuePtrPtr缓冲区列最初已按如下所示绑定到的地址:
绑定地址 + 绑定偏移量+ ((行号– 1) x元素大小)
其中变量定义下表中所示。
| 变量 | Description |
|---|---|
| 绑定地址 | 使用指定的地址TargetValuePtr中的参数SQLBindCol。 |
| 绑定偏移量 | 存储与 SQL_ATTR_ROW_BIND_OFFSET_PTR 语句属性指定的地址的值。 |
| 行号 | 从 1 开始的行集中的行数。 对于单行提取操作,这是默认值,这是 1。 |
| 元素大小 | 数据和长度/指示器缓冲区将 SQL_ATTR_ROW_BIND_TYPE 语句属性的值。 |
它还会返回 SQL_NEED_DATA,这是一个指示符,则应调用的应用程序SQLPutData发送数据。
应用程序调用SQLPutData尽可能多地需要发送的列或参数的数据执行时数据。 列或参数发送的所有数据后,应用程序调用SQLParamData试。 如果SQLParamData再次返回 SQL_NEED_DATA,必须将数据发送另一个参数或列。 因此,再次将应用程序调用SQLPutData。 如果执行时数据的所有数据已都发送的所有参数或列,然后SQLParamData返回 SQL_SUCCESS 或 SQL_SUCCESS_WITH_INFO 中的值 *ValuePtrPtr未定义,和可执行 SQL 语句或SQLBulkOperations或SQLSetPos调用可以进行处理。
如果SQLParamData提供,数量参数的数据搜索 update 或 delete 语句,但不影响任何行在数据源,调用SQLParamData返回 sql_no_data 为止。
在语句执行时传递有关如何执行时的数据参数数据的详细信息,请参阅"传递参数值"中SQLBindParameter并发送长数据。 对于更新或添加有关如何执行时的数据列数据的详细信息,请参阅"使用 SQLSetPos"一节中SQLSetPos,"执行大容量更新使用中的书签" SQLBulkOperations,并Long 数据和 SQLSetPos 及 SQLBulkOperations。
SQLParamData可以调用以检索经过流处理的输出参数。 当SQLMoreResults, SQLExecute, SQLGetData,或者SQLExecDirect返回 SQL_PARAM_DATA_AVAILABLE,调用SQLParamData以确定哪些参数的可用值。 有关 SQL_PARAM_DATA_AVAILABLE 和流式处理的输出参数的详细信息,请参阅使用 SQLGetData 检索输出参数。
代码示例
请参阅SQLPutData。
相关函数
| 有关信息 | 请参阅 |
|---|---|
| 绑定到参数的缓冲区 | SQLBindParameter 函数 |
| 取消语句处理 | SQLCancel 函数 |
| 在语句中返回有关参数的信息 | SQLDescribeParam 函数 |
| 执行 SQL 语句 | SQLExecDirect 函数 |
| 执行已准备的 SQL 语句 | SQLExecute 函数 |
| 在执行时发送参数数据 | SQLPutData 函数 |
请参阅
ODBC API 参考
ODBC 头文件
使用 SQLGetData 检索输出参数
历史资料。此文对应 2018-11-30 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 MightyPen)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
