语句转换
ODBC 语句具有以下状态。
| 状态 | 说明 |
|---|---|
| S0 | 未分配的语句。 (连接状态必须为 C4、C5 或 C6。有关详细信息，请参阅 Connection Transitions.) |
| S1 | Allocated 语句。 |
| S2 | 准备语句。 不会创建任何结果集。 |
| S3 | 准备语句。 将创建一个 (可能为空) 结果集。 |
| S4 | 已执行语句，但未创建任何结果集。 |
| S5 | 语句已执行，创建结果集) (可能为空。 游标处于打开状态，位于结果集的第一行之前。 |
| S6 | 游标使用 SQLFetch 或 SQLFetchScroll 定位。 |
| S7 | 游标使用 SQLExtendedFetch 定位。 |
| S8 | 函数需要数据。 尚未调用 SQLParamData。 |
| S9 | 函数需要数据。 尚未调用 SQLPutData。 |
| S10 | 函数需要数据。 已调用 SQLPutData。 |
| S11 | 仍在执行。 在异步执行的函数返回SQL_STILL_EXECUTING后，语句将保持此状态。 在执行接受语句句柄的任何函数时，语句暂时处于此状态。 除 SQLCancel 的状态表外，S11 州中的临时居住地不会显示在任何状态表中。 当语句暂时处于 S11 状态时，可以通过从另一个线程调用 SQLCancel 来取消该函数。 |
| S12 | 异步执行已取消。 在 S12 中，应用程序必须调用取消的函数，直到返回除 SQL_STILL_EXECUTING 以外的值。 仅当函数返回SQL_ERROR且 SQLSTATE HY008 (操作) 取消时，函数才会成功取消。 如果它返回任何其他值（如SQL_SUCCESS），则取消操作失败，函数正常执行。 |
状态 S2 和 S3 称为准备状态，将 S5 到 S7 状态作为游标状态，将 S8 到 S10 声明为需要数据状态，将 S11 和 S12 声明为异步状态。 在每个组中，转换仅在组中每个状态不同时才单独显示;在大多数情况下，组中的每个状态的转换都是相同的。
下表显示了每个 ODBC 函数如何影响语句状态。
SQLAllocHandle
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| --[1], [5], [6] | --[5] | --[5] | --[5] | --[5] | --[5] | --[5] |
| --[2], [5] | --[5] | --[5] | --[5] | --[5] | --[5] | --[5] |
| S1[3] | --[5] | --[5] | --[5] | --[5] | --[5] | --[5] |
| --[4], [5] | --[5] | --[5] | --[5] | --[5] | --[5] | --[5] |
[1] 此行显示SQL_HANDLE_ENV HandleType 时的转换。
[2] 此行显示SQL_HANDLE_DBC HandleType 时的转换。
[3] 此行显示 SQL_HANDLE_STMT HandleType 时的转换。
[4] 此行显示SQL_HANDLE_DESC HandleType 时的转换。
[5] 使用指向有效句柄的 OutputHandlePtr 调用 SQLAllocHandle 会覆盖该句柄，而不考虑该句柄的先前内容，并可能导致 ODBC 驱动程序出现问题。 使用为 OutputHandlePtr 定义的同一应用程序变量调用 SQLAllocHandle 两次，而不调用 SQLFreeHandle 以在重新分配句柄之前释放句柄，这是不正确的 ODBC 应用程序编程。 以这种方式覆盖 ODBC 句柄可能会导致 ODBC 驱动程序的行为不一致或错误。
SQLBindCol
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| IH | -- | -- | -- | -- | HY010 | HY010 |
SQLBindParameter
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| IH | -- | -- | -- | -- | HY010 | HY010 |
SQLBrowseConnect、SQLConnect 和 SQLDriverConnect
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| 08002 | 08002 | 08002 | 08002 | 08002 | 08002 | 08002 |
SQLBulkOperations
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| IH | HY010 | HY010 | 24000 | 请参阅下一表 | HY010 | NS [c] HY010 o |
SQLBulkOperations (游标状态)
| S5 已打开 |
S6 SQLFetch 或 SQLFetchScroll |
S7 SQLExtendedFetch |
|---|---|---|
| -- [s] S8 [d] S11 [x] | -- [s] S8 [d] S11 [x] | HY010 |
SQLCancel
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| IH | -- | -- | -- | -- | S1[1] S2 [nr] 和 [2] S3 [r]和 [2] S5[3] 和 [5] S6 ([3] 或 [4]) 和 [6] S7[4] 和 [7] | 请参阅下一表 |
[1] SQLExecDirect 返回SQL_NEED_DATA。
[2] SQLExecute 返回SQL_NEED_DATA。
[3] SQLBulkOperations 返回SQL_NEED_DATA。
[4] SQLSetPos 已返回SQL_NEED_DATA。
[5] 尚未调用 SQLFetch、 SQLFetchScroll 或 SQLExtendedFetch 。
[6] 已调用 SQLFetch 或 SQLFetchScroll 。
[7] 已调用 SQLExtendedFetch 。
SQLCancel (异步状态)
| S11 仍在执行 |
S12 Asynch 已取消 |
|---|---|
| NS[1] S12[2] | S12 |
[1] 语句在执行函数时暂时处于 S11 状态。 SQLCancel 是从其他线程调用的。
[2] 语句处于 S11 状态，因为SQL_STILL_EXECUTING异步返回了名为 的函数。
SQLCloseCursor
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| IH | 24000 | 24000 | 24000 | S1 [np] S3 [p] | HY010 | HY010 |
SQLColAttribute
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| IH | HY010 | 请参阅下一表 | 24000 | -- [s] S11 [x] | HY010 | NS [c] HY010 o |
SQLColAttribute (准备状态)
| S2 无结果 |
S3 结果 |
|---|---|
| --[1] 07005[2] | -- [s] S11 x |
[1] 已SQL_DESC_COUNT FieldIdentifier 。
[2] 未SQL_DESC_COUNT FieldIdentifier 。
SQLColumnPrivileges、SQLColumns、SQLForeignKeys、SQLGetTypeInfo、SQLPrimaryKeys、SQLProcedureColumns、SQLProcedures、SQLSpecialColumns、SQLStatistics、SQLTablePrivileges 和 SQLTables
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| (IH) | S5 [s] S11 [x] | S1 [e] S5 [s] S11 [x] | S1 [e] 和 [1] S5 [s] 和 [1] S11 [x] 和 [1] 24000[2] | 请参阅下一表 | HY010 | NS [c] HY010 o |
[1] 当前结果是最后一个或唯一的结果，或者没有当前结果。 有关多个结果的详细信息，请参阅 多个结果。
[2] 当前结果不是最后一个结果。
SQLColumnPrivileges、SQLColumns、SQLForeignKeys、SQLGetTypeInfo、SQLPrimaryKeys、SQLProcedureColumns、SQLProcedures、SQLSpecialColumns、SQLStatistics、SQLTablePrivileges 和 SQLTables (游标状态)
| S5 已打开 |
S6 SQLFetch 或 SQLFetchScroll |
S7 SQLExtendedFetch |
|---|---|---|
| 24000 | 24000[1] | 24000 |
[1] 如果 SQLFetch 或SQLFetchScroll 未返回SQL_NO_DATA，则驱动程序管理器将返回此错误，如果 SQLFetch 或 SQLFetchScroll 已返回SQL_NO_DATA，则由驱动程序返回。
SQLCopyDesc
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| IH[1] | -- | -- | -- | -- | HY010 | NS [c] 和 [3] HY010 [o] 或 [4] |
| IH[2] | HY010 | 请参阅下一个表 | 24000 | -- [s] S11 x | HY010 | NS [c] 和 [3] HY010 [o] 或 [4] |
[1] 此行显示 SourceDescHandle 参数为 ARD、APD 或 IPD 时的转换。
[2] 当 SourceDescHandle 参数为 IRD 时，此行显示转换。
[3] SourceDescHandle 和 TargetDescHandle 参数与异步运行的 SQLCopyDesc 函数中的参数相同。
[4] SourceDescHandle 参数或 TargetDescHandle 参数 (或两者) 都不同于异步运行的 SQLCopyDesc 函数。
SQLCopyDesc (准备状态)
| S2 无结果 |
S3 结果 |
|---|---|
| 24000[1] | -- [s] S11 [x] |
[1]此行显示 SourceDescHandle 参数为 IRD 时的转换。
SQLDataSources 和 SQLDrivers
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| -- | -- | -- | -- | -- | -- | -- |
SQLDescribeCol
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| IH | HY010 | 请参阅下一个表 | 24000 | -- [s] S11 [x] | HY010 | NS [c] HY010 o |
SQLDescribeCol (准备状态)
| S2 无结果 |
S3 结果 |
|---|---|
| 07005 | -- [s] S11 [x] |
SQLDescribeParam
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| IH | HY010 | -- [s] S11 [x] | HY010 | HY010 | HY010 | NS [c] HY010 [o] |
SQLDisconnect
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| --[1] | S0[1] | S0[1] | S0[1] | S0[1] | (HY010) | (HY010) |
[1] 调用 SQLDisconnect 可释放与连接关联的所有语句。 此外，这会将连接状态返回到 C2;在语句状态为 S0 之前，连接状态必须为 C4。
SQLEndTran
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| -- | -- | --[2] 或 [3] S1[1] | --[3] S1 [np] 和 ([1] 或 [2]) S1 [p] 和 [1] S2 [p] 和 [2] | --[3] S1 [np] 和 ([1] 或 [2]) S1 [p] 和 [1] S3 [p] 和 [2] | (HY010) | (HY010) |
[1] CompletionType 参数SQL_COMMIT SQLGetInfo 返回SQL_CURSOR_COMMIT_BEHAVIOR信息类型的SQL_CB_DELETE，或者 CompletionType 参数为SQL_ROLLBACK， SQLGetInfo 返回SQL_CURSOR_ROLLBACK_BEHAVIOR信息类型的SQL_CB_DELETE。
[2] CompletionType 参数为SQL_COMMIT， SQLGetInfo 返回SQL_CURSOR_COMMIT_BEHAVIOR信息类型的SQL_CB_CLOSE，或者 CompletionType 参数为SQL_ROLLBACK， SQLGetInfo 返回SQL_CURSOR_ROLLBACK_BEHAVIOR信息类型的SQL_CB_CLOSE。
[3] CompletionType 参数为SQL_COMMIT， SQLGetInfo 返回SQL_CURSOR_COMMIT_BEHAVIOR信息类型的SQL_CB_PRESERVE，或者 CompletionType 参数为SQL_ROLLBACK， SQLGetInfo 返回SQL_CURSOR_ROLLBACK_BEHAVIOR信息类型的SQL_CB_PRESERVE。
SQLExecDirect
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| (IH) | S4 [s] 和 [nr] S5 [s] 和 [r] S8 [d] S11 [x] | -- [e] 和 [1] S1 [e] 和 [2] S4 [s] 和 [nr] S5 [s] 和 [r] S8 [d] S11 [x] | -- [e]、[1]和 [3] S1 [e]、[2]和 [3] S4 [s]、[nr]和 [3] S5 [s]、[r]和 [3] S8 [d] 和 [3] S11 [x] 和 [3] 24000 [4] | 请参阅下一表 | HY010 | NS [c] HY010 [o] |
[1] 错误是由驱动程序管理器返回的。
[2] 驱动程序管理器未返回错误。
[3] 当前结果是最后一个或唯一的结果，或者没有当前结果。 有关多个结果的详细信息，请参阅 多个结果。
[4] 当前结果不是最后一个结果。
SQLExecDirect (游标状态)
| S5 已打开 |
S6 SQLFetch 或 SQLFetchScroll |
S7 SQLExtendedFetch |
|---|---|---|
| 24000 | 24000 [1] | 24000 |
[1] 如果 SQLFetch 或 SQLFetchScroll 未返回SQL_NO_DATA，则驱动程序管理器将返回此错误;如果 SQLFetch 或 SQLFetchScroll 已返回SQL_NO_DATA，则由驱动程序返回此错误。
SQLExecute
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| (IH) | (HY010) | 请参阅下一表 | S2 [e]、p 和 [1] S4 [s]、[p]、[nr]和 [1] S5 [s]、[p]、[r]和 [1] S8 [d]、[p]和 [1] S11 [x]、[p]和 [1] 24000 [p] 和 [2] HY010 [np] | 请参阅游标状态表 | HY010 | NS [c] HY010 [o] |
[1] 当前结果是最后一个或唯一的结果，或者没有当前结果。 有关多个结果的详细信息，请参阅 多个结果。
[2] 当前结果不是最后一个结果。
SQLExecute (准备状态)
| S2 无结果 |
S3 结果 |
|---|---|
| S4 [s] S8 [d] S11 [x] | S5 [s] S8 [d] S11 [x] |
SQLExecute (游标状态)
| S5 已打开 |
S6 SQLFetch 或 SQLFetchScroll |
S7 SQLExtendedFetch |
|---|---|---|
| 24000 [p] HY010 [np] | 24000 [p]， [1] HY010 [np] | 24000 [p] HY010 [np] |
[1] 如果 SQLFetch 或 SQLFetchScroll 未返回SQL_NO_DATA，则驱动程序管理器将返回此错误;如果 SQLFetch 或 SQLFetchScroll 已返回SQL_NO_DATA，则由驱动程序返回此错误。
SQLExtendedFetch
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| IH | S1010 | S1010 | 24000 | 请参阅下一表 | S1010 | NS [c] S1010 [o] |
SQLExtendedFetch (游标状态)
| S5 已打开 |
S6 SQLFetch 或 SQLFetchScroll |
S7 SQLExtendedFetch |
|---|---|---|
| S7 [s] 或 [nf] S11 [x] | S1010 | -- [s] 或 [nf] S11 [x] |
SQLFetch 和 SQLFetchScroll
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| IH | HY010 | HY010 | 24000 | 请参阅下一表 | HY010 | NS [c] HY010 [o] |
SQLFetch 和 SQLFetchScroll (游标状态)
| S5 已打开 |
S6 SQLFetch 或 SQLFetchScroll |
S7 SQLExtendedFetch |
|---|---|---|
| S6 [s] 或 [nf] S11 [x] | -- [s] 或 [nf] S11 [x] | HY010 |
SQLFreeHandle
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| -- [1] | HY010 | HY010 | HY010 | HY010 | HY010 | HY010 |
| IH [2] | S0 | S0 | S0 | S0 | HY010 | HY010 |
| -- [3] | -- | -- | -- | -- | -- | -- |
[1] 此行显示SQL_HANDLE_ENV或SQL_HANDLE_DBC HandleType 时的转换。
[2] 此行显示SQL_HANDLE_STMT HandleType 时的转换。
[3] 此行显示SQL_HANDLE_DESC HandleType 且显式分配描述符时的转换。
SQLFreeStmt
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| IH [1] | -- | -- | S1 [np] S2 [p] | S1 [np] S3 [p] | HY010 | HY010 |
| IH [2] | -- | -- | -- | -- | HY010 | HY010 |
[1] 此行显示SQL_CLOSE Option 时的转换。
[2] 此行显示选项SQL_UNBIND或 SQL_RESET_PARAMS时的转换 。 如果 Option 参数SQL_DROP并且基础驱动程序是 ODBC 3*.x* 驱动程序，则驱动程序管理器将此映射到 SQLFreeHandle 的调用，并将 HandleType 设置为 SQL_HANDLE_STMT。 有关详细信息，请参阅 SQLFreeHandle 的转换表。
SQLGetConnectAttr
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| -- | -- | -- | -- | -- | -- | -- |
SQLGetCursorName
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| IH | -- | -- | -- | -- | HY010 | HY010 |
SQLGetData
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| IH | HY010 | HY010 | 24000 | 请参阅下一个表 | HY010 | NS [c] HY010 [o] |
SQLGetData (游标状态)
| S5 已打开 |
S6 SQLFetch 或 SQLFetchScroll |
S7 SQLExtendedFetch |
|---|---|---|
| 24000 | -- [s] 或 [nf] S11 [x] 24000 [b] HY109 [i] | -- [s] 或 [nf] S11 [x] 24000 [b] HY109 [i] |
SQLGetDescField 和 SQLGetDescRec
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| IH | -- [1] 或 [2] HY010 [3] | 请参阅下一个表 | -- [1] 或 [2] 24000 [3] | -- [1]、[2]或 [3] S11 [3] 和 [x] | HY010 | NS [c] 或 [4] HY010 [o] 和 [5] |
[1] DescriptorHandle 参数是 APD 或 ARD。
[2] DescriptorHandle 参数是 IPD。
[3] DescriptorHandle 参数是 IRD。
[4] DescriptorHandle 参数与异步运行的 SQLGetDescField 或 SQLGetDescRec 函数中的 DescriptorHandle 参数相同。
[5] DescriptorHandle 参数不同于以异步方式运行的 SQLGetDescField 或 SQLGetDescRec 函数中的 DescriptorHandle 参数。
SQLGetDescField 和 SQLGetDescRec (准备状态)
| S2 无结果 |
S3 结果 |
|---|---|
| --[1]、[2]或 [3] S11[2] 和 [x] | --[1]、[2]或 [3] S11 [x] |
[1] DescriptorHandle 参数是 APD 或 ARD。
[2] DescriptorHandle 参数是 IPD。
[3] DescriptorHandle 参数是 IRD。 请注意，当 DescriptorHandle 是 IRD 时，这些函数始终返回状态为 S2 的SQL_NO_DATA。
SQLGetDiagField 和 SQLGetDiagRec
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| --[1] | -- | -- | -- | -- | -- | -- |
| IH[2] | --[3] | --[3] | -- | -- | --[3] | --[3] |
[1] 此行显示SQL_HANDLE_ENV、SQL_HANDLE_DBC或SQL_HANDLE_DESC HandleType 时的转换。
[2] 此行显示SQL_HANDLE_STMT HandleType 时的转换。
[3] SQL_DIAG_ROW_COUNT DiagIdentifier 时，SQLGetDiagField 始终返回此状态下的错误。
SQLGetEnvAttr
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| -- | -- | -- | -- | -- | -- | -- |
SQLGetFunctions
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| -- | -- | -- | -- | -- | -- | -- |
SQLGetInfo
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| -- | -- | -- | -- | -- | -- | -- |
SQLGetStmtAttr
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| IH | --[1] 24000[2] | --[1] 24000[2] | --[1] 24000[2] | 请参阅下一表 | HY010 | HY010 |
[1] 语句属性未SQL_ATTR_ROW_NUMBER。
[2] 语句属性已SQL_ATTR_ROW_NUMBER。
SQLGetStmtAttr (游标状态)
| S5 已打开 |
S6 SQLFetch 或 SQLFetchScroll |
S7 SQLExtendedFetch |
|---|---|---|
| --[1] 24000[2] | --[1] 或 ([v] 和 [2]) 24000 [b] 和 [2] HY109 [i] 和 [2] | -- [i] 或 ([v] 和 [2]) 24000 [b] 和 [2] HY109[1] 和 [2] |
[1] 属性参数未 SQL_ATTR_ROW_NUMBER。
[2] 属性 参数已SQL_ATTR_ROW_NUMBER。
SQLMoreResults
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| (IH) | --[1] | --[1] | -- [s] 和 [2] S1 [nf]、[np]和 [4] S2 [nf]， [p]， 和 [4] S5 [s] 和 [3] S11 [x] | S1 [nf]、[np]和 [4] S3 [nf]、[p] 和 [4] S4 [s] 和 [2] S5 [s] 和 [3] S11 [x] | HY010 | NS [c] HY010 [o] |
[1] 函数始终返回处于此状态的SQL_NO_DATA。
[2] 下一个结果是行计数。
[3] 下一个结果是结果集。
[4] 当前结果是最后一个结果。
SQLNativeSql
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| -- | -- | -- | -- | -- | -- | -- |
SQLNumParams
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| IH | HY010 | -- [s] S11 [x] | -- [s] S11 [x] | -- [s] S11 [x] | HY010 | NS [c] HY010 [o] |
SQLNumResultCols
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| IH | HY010 | -- [s] S11 [x] | -- [s] S11 [x] | -- [s] S11 [x] | HY010 | NS [c] HY010 [o] |
SQLParamData
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| IH | HY010 | HY010 | HY010 | HY010 | 请参阅下一表 | NS [c] HY010 [o] |
SQLParamData (需要数据状态)
| S8 需要数据 |
S9 必须放置 |
S10 可放置 |
|---|---|---|
| S1 [e] 和 [1] S2 [e]、[nr]和 [2] S3 [e]， [r] 和 [2] S5 [e] 和 [4] S6 [e] 和 [5] S7 [e] 和 [3] S9 [d] S11 [x] | HY010 | S1 [e] 和 [1] S2 [e]、[nr]和 [2] S3 [e]、[r]和 [2] S4 [s]、[nr]和 ([1] 或 [2]) S5 [s]， [r]、 ([1] 或 [2]) S5 ([s] 或 [e]) 和 [4] S6 ([s] 或 [e]) 和 [5] S7 ([s] 或 [e]) 和 [3] S9 [d] S11 [x] |
[1] SQLExecDirect 返回SQL_NEED_DATA。
[2] SQLExecute 返回SQL_NEED_DATA。
[3] SQLSetPos 已从状态 S7 调用并返回SQL_NEED_DATA。
[4] SQLBulkOperations 已从状态 S5 调用并返回SQL_NEED_DATA。
[5] SQLSetPos 或 SQLBulkOperations 已从状态 S6 调用并返回SQL_NEED_DATA。
SQLPrepare
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| (IH) | S2 [s] 和 [nr] S3 [s] 和 [r] S11 [x] | -- [s] 或 ([e] 和 [1]) S1 [e] 和 [2] S11 [x] | S1 [e] 和 [3] S2 [s]、 [nr]和 [3] S3 [s]， [r] 和 [3] S11 [x] 和 [3] 24000[4] | 请参阅下一表 | HY010 | NS [c] HY010 [o] |
[1] 由于验证 SQLSTATE 为 HY009 [参数值无效] 或 HY090 [无效字符串或缓冲区长度] () ，否则，准备失败的原因为验证语句。
[2] 在验证 SQLSTATE 不是 HY009 [参数值无效] 或 HY090 [无效字符串或缓冲区长度] () 时，准备失败。
[3] 当前结果是最后一个或唯一的结果，或者没有当前结果。 有关多个结果的详细信息，请参阅 多个结果。
[4] 当前结果不是最后一个结果。
SQLPrepare (游标状态)
| S5 已打开 |
S6 SQLFetch 或 SQLFetchScroll |
S7 SQLExtendedFetch |
|---|---|---|
| 24000 | 24000 | 24000 |
SQLPutData
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| IH | HY010 | HY010 | HY010 | HY010 | 请参阅下一表 | NS [c] HY010 [o] |
SQLPutData (需要数据状态)
| S8 需要数据 |
S9 必须放置 |
S10 可放置 |
|---|---|---|
| HY010 | S1 [e] 和 [1] S2 [e]、[nr]和 [2] S3 [e]、 [r]和 [2] S5 [e] 和 [4] S6 [e] 和 [5] S7 [e] 和 [3] S10 [s] S11 [x] | -- [s] S1 [e] and [1] S2 [e]， [nr]， and [2] S3 [e]， [r] 和 [2] S5 [e] 和 [4] S6 [e] 和 [5] S7 [e] 和 [3] S11 [x] HY011[6] |
[1] SQLExecDirect 返回SQL_NEED_DATA。
[2] SQLExecute 返回SQL_NEED_DATA。
[3] SQLSetPos 已从状态 S7 调用并返回SQL_NEED_DATA。
[4] SQLBulkOperations 已从状态 S5 调用并返回SQL_NEED_DATA。
[5] SQLSetPos 或 SQLBulkOperations 已从状态 S6 调用并返回SQL_NEED_DATA。
[6] 针对SQL_SUCCESS返回的单个参数对 SQLPutData 进行一次或多项调用，然后针对同一参数调用 SQLPutData ， StrLen_or_Ind 设置为SQL_NULL_DATA。
SQLRowCount
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| (IH) | (HY010) | (HY010) | -- | -- | (HY010) | (HY010) |
SQLSetConnectAttr
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| --[1] | -- | -- | -- | --[2] 24000[3] | HY010 | HY010 |
[1] 当 Attribute 是连接属性时，此行显示转换。 有关 Attribute 为语句属性时的转换，请参阅 SQLSetStmtAttr 的语句转换表。
[2] 未SQL_ATTR_CURRENT_CATALOG Attribute 参数。
[3] 已SQL_ATTR_CURRENT_CATALOG Attribute 参数。
SQLSetCursorName
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| IH | -- | -- | 24000 | 24000 | HY010 | HY010 |
SQLSetDescField 和 SQLSetDescRec
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| IH[1] | -- | -- | -- | -- | HY010 | HY010 |
[1] 此行显示当 FieldIdentifier 参数SQL_DESC_ARRAY_STATUS_PTR或SQL_DESC_ROWS_PROCESSED_PTR时，DescriptorHandle 参数为 ARD、APD、IPD 或 SQLSetDDD (的转换) IRD。 当 FieldIdentifier 为任何其他值时，为 IRD 调用 SQLSetDescField 是一个错误。
SQLSetEnvAttr
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| HY011 | HY011 | HY011 | HY011 | Y011 | HY01 | HY011 |
SQLSetPos
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| IH | HY010 | HY010 | 24000 | 请参阅下一个表 | HY010 | NS [c] HY010 [o] |
SQLSetPos (游标状态)
| S5 已打开 |
S6 SQLFetch 或 SQLFetchScroll |
S7 SQLExtendedFetch |
|---|---|---|
| 24000 | -- [s] S8 [d] S11 [x] 24000 [b] HY109 [i] | -- [s] S8 [d] S11 [x] 24000 [b] HY109 [i] |
SQLSetStmtAttr
| S0 未分配 |
S1 已分配 |
S2-S3 Prepared |
S4 执行 |
S5-S7 游标 |
S8-S10 需要数据 |
S11-S12 异步 |
|---|---|---|---|---|---|---|
| IH | -- | --[1] HY011[2] | --[1] 24000[2] | --[1] 24000[2] | HY010 [np] 或 [1] HY011 [p] 和 [2] | HY010 [np] 或 [1] HY011 [p] 和 [2] |
[1] Attribute 参数不是SQL_ATTR_CONCURRENCY、SQL_ATTR_CURSOR_TYPE、SQL_ATTR_SIMULATE_CURSOR、SQL_ATTR_USE_BOOKMARKS、SQL_ATTR_CURSOR_SCROLLABLE或SQL_ATTR_CURSOR_SENSITIVITY。
[2] Attribute 参数SQL_ATTR_CONCURRENCY、SQL_ATTR_CURSOR_TYPE、SQL_ATTR_SIMULATE_CURSOR、SQL_ATTR_USE_BOOKMARKS、SQL_ATTR_CURSOR_SCROLLABLE或SQL_ATTR_CURSOR_SENSITIVITY。