ODBC 語句具有下列狀態。
| State | 描述 |
|---|---|
| S0 | 未配置語句。 （線上狀態必須是 C4、C5 或 C6。如需詳細資訊，請參閱 連線轉換 。） |
| 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 Async |
|---|---|---|---|---|---|---|
| --[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] 當 HandleType SQL_HANDLE_ENV時 ，此資料列會顯示轉換。
[2] 當 HandleType 已SQL_HANDLE_DBC時 ，此資料列會顯示轉換。
[3] 當 HandleType SQL_HANDLE_STMT時 ，此資料列會顯示轉換。
[4] 當 HandleType SQL_HANDLE_DESC時 ，此資料列會顯示轉換。
[5] 使用 OutputHandlePtr 呼叫 SQLAllocHandle ，指出有效的控制碼會覆寫該控制碼，而不考慮該控制碼先前的內容，而且可能會導致 ODBC 驅動程式發生問題。 ODBC 應用程式程式設計不正確，使用針對 *OutputHandlePtr 定義的 相同應用程式變數來呼叫 SQLAllocHandle 兩次，而不需呼叫 SQLFreeHandle 來釋放控制碼，然後再重新配置它。 以這種方式覆寫 ODBC 控制碼可能會導致 ODBC 驅動程式的行為或錯誤不一致。
SQLBindCol
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| Ih | -- | -- | -- | -- | HY010 | HY010 |
SQLBindParameter
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| Ih | -- | -- | -- | -- | HY010 | HY010 |
SQLBrowseConnect、SQLConnect 和 SQLDriverConnect
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| 08002 | 08002 | 08002 | 08002 | 08002 | 08002 | 08002 |
SQLBulkOperations
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| Ih | HY010 | HY010 | 24000 | 請參閱下一個表格 | HY010 | NS [c] HY010 o |
SQLBulkOperations （資料指標狀態）
| S5 Opened |
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 Async |
|---|---|---|---|---|---|---|
| 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] SQL_NEED_DATA傳回的 SQLSetPos 。
[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 Async |
|---|---|---|---|---|---|---|
| Ih | 24000 | 24000 | 24000 | S1 [np] S3 [p] | HY010 | HY010 |
SQLColAttribute
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| Ih | HY010 | 請參閱下一個表格 | 24000 | -- [s] S11 [x] | HY010 | NS [c] HY010 o |
SQLColAttribute （準備狀態）
| S2 沒有結果 |
S3 結果 |
|---|---|
| --[1] 07005[2] | -- [s] S11 x |
[1] FieldIdentifier 已SQL_DESC_COUNT。
[2] FieldIdentifier 未SQL_DESC_COUNT。
SQLColumnPrivileges、SQLColumns、SQLForeignKeys、SQLGetTypeInfo、SQLPrimaryKeys、SQLProcedureColumns、SQLProcedures、SQLSpecialColumns、SQLStatistics、SQLTablePrivileges 和 SQLTables
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| （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 Opened |
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 Async |
|---|---|---|---|---|---|---|
| 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 Async |
|---|---|---|---|---|---|---|
| -- | -- | -- | -- | -- | -- | -- |
SQLDescribeCol
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| 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 Async |
|---|---|---|---|---|---|---|
| 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 Async |
|---|---|---|---|---|---|---|
| --[1] | S0[1] | S0[1] | S0[1] | S0[1] | （HY010） | （HY010） |
[1] 呼叫 SQLDisconnect 會釋放與連線相關聯的所有語句。 此外，這會將線上狀態傳回 C2;連接狀態必須是 C4，語句狀態為 S0。
SQLEndTran
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| -- | -- | --[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 Async |
|---|---|---|---|---|---|---|
| （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 Opened |
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 Async |
|---|---|---|---|---|---|---|
| （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 Opened |
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 Async |
|---|---|---|---|---|---|---|
| Ih | S1010 | S1010 | 24000 | 請參閱下一個表格 | S1010 | NS [c] S1010 [o] |
SQLExtendedFetch （資料指標狀態）
| S5 Opened |
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 Async |
|---|---|---|---|---|---|---|
| Ih | HY010 | HY010 | 24000 | 請參閱下一個表格 | HY010 | NS [c] HY010 [o] |
SQLFetch 和 SQLFetchScroll （資料指標狀態）
| S5 Opened |
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 Async |
|---|---|---|---|---|---|---|
| -- [1] | HY010 | HY010 | HY010 | HY010 | HY010 | HY010 |
| IH [2] | S0 | S0 | S0 | S0 | HY010 | HY010 |
| -- [3] | -- | -- | -- | -- | -- | -- |
[1] 當 HandleType 已SQL_HANDLE_ENV或SQL_HANDLE_DBC時 ，此資料列會顯示轉換。
[2] 當 HandleType SQL_HANDLE_STMT時 ，此資料列會顯示轉換。
[3] 當 HandleType 已SQL_HANDLE_DESC且明確配置描述項時 ，此資料列會顯示轉換。
SQLFreeStmt
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| IH [1] | -- | -- | S1 [np] S2 [p] | S1 [np] S3 [p] | HY010 | HY010 |
| IH [2] | -- | -- | -- | -- | HY010 | HY010 |
[1] 當 Option SQL_CLOSE 時 ，此資料列會顯示轉換。
[2] 當 Option 已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 Async |
|---|---|---|---|---|---|---|
| -- | -- | -- | -- | -- | -- | -- |
SQLGetCursorName
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| Ih | -- | -- | -- | -- | HY010 | HY010 |
SQLGetData
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| Ih | HY010 | HY010 | 24000 | 請參閱下一個表格 | HY010 | NS [c] HY010 [o] |
SQLGetData （資料指標狀態）
| S5 Opened |
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 Async |
|---|---|---|---|---|---|---|
| Ih | -- [1] 或 [2] HY010 [3] | 請參閱下一個表格 | -- [1] 或 [2] 24000 [3] | -- [1]、[2]或 [3] S11 [3] 和 [x] | HY010 | NS [c] 或 [4] HY010 [o] 和 [5] |
[1] 描述元Handle 引數是 APD 或 ARD。
[2] 描述元Handle 引數是 IPD。
[3] 描述元Handle 引數是 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] 描述元Handle 引數是 APD 或 ARD。
[2] 描述元Handle 引數是 IPD。
[3] 描述元Handle 引數是 IRD。 請注意，當 DescriptorHandle 是 IRD 時 ，這些函式一律會在狀態 S2 中傳回SQL_NO_DATA。
SQLGetDiagField 和 SQLGetDiagRec
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| --[1] | -- | -- | -- | -- | -- | -- |
| IH[2] | --[3] | --[3] | -- | -- | --[3] | --[3] |
[1] 當 HandleType 已SQL_HANDLE_ENV、SQL_HANDLE_DBC或SQL_HANDLE_DESC時 ，此資料列會顯示轉換。
[2] 當 HandleType SQL_HANDLE_STMT時 ，此資料列會顯示轉換。
[3] 當 DiagIdentifier SQL_DIAG_ROW_COUNT 時 ，SQLGetDiagField 一律會傳回此狀態的錯誤。
SQLGetEnvAttr
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| -- | -- | -- | -- | -- | -- | -- |
SQLGetFunctions
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| -- | -- | -- | -- | -- | -- | -- |
SQLGetInfo
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| -- | -- | -- | -- | -- | -- | -- |
SQLGetStmtAttr
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| Ih | --[1] 24000[2] | --[1] 24000[2] | --[1] 24000[2] | 請參閱下一個表格 | HY010 | HY010 |
[1] 語句屬性未SQL_ATTR_ROW_NUMBER。
[2] 語句屬性已SQL_ATTR_ROW_NUMBER。
SQLGetStmtAttr （資料指標狀態）
| S5 Opened |
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] Attribute 引數未SQL_ATTR_ROW_NUMBER。
[2] Attribute 引數已SQL_ATTR_ROW_NUMBER。
SQLMoreResults
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| （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 Async |
|---|---|---|---|---|---|---|
| -- | -- | -- | -- | -- | -- | -- |
SQLNumParams
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| 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 Async |
|---|---|---|---|---|---|---|
| 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 Async |
|---|---|---|---|---|---|---|
| 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 Async |
|---|---|---|---|---|---|---|
| （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 Opened |
S6 SQLFetch 或 SQLFetchScroll |
S7 SQLExtendedFetch |
|---|---|---|
| 24000 | 24000 | 24000 |
SQLPutData
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| 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] 和 [1] S2 [e]， [nr]， 和 [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] 針對傳回的單一參數對 SQLPutData 進行一或多個呼叫SQL_SUCCESS，然後 針對相同參數 呼叫 SQLPutData ，並將StrLen_or_Ind 設定為 SQL_Null_DATA。
SQLRowCount
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| （IH） | （HY010） | （HY010） | -- | -- | （HY010） | （HY010） |
SQLSetConnectAttr
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| --[1] | -- | -- | -- | --[2] 24000[3] | HY010 | HY010 |
[1] 當 Attribute 是連接屬性時 ，此資料列會顯示轉換。 如需 Attribute 是語句屬性時的 轉換，請參閱 SQLSetStmtAttr 的 語句轉換資料表。
[2] Attribute 引數未SQL_ATTR_CURRENT_CATALOG。
[3] Attribute 引數已SQL_ATTR_CURRENT_CATALOG。
SQLSetCursorName
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| Ih | -- | -- | 24000 | 24000 | HY010 | HY010 |
SQLSetDescField 和 SQLSetDescRec
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| IH[1] | -- | -- | -- | -- | HY010 | HY010 |
[1] 當 FieldIdentifier 引數SQL_DESC_ARRAY_STATUS_PTR或SQL_DESC_ROWS_PROCESSED_PTR時 ，此資料列會顯示 DescriptorHandle 引數為 ARD、APD、IPD 或 （for SQLSetDescField ） IRD 的轉換 。 當 FieldIdentifier 為任何其他值時 ，呼叫 IRD 的 SQLSetDescField 是錯誤 。
SQLSetEnvAttr
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| HY011 | HY011 | HY011 | HY011 | Y011 | HY01 | HY011 |
SQLSetPos
| S0 未配置 |
S1 已配置 |
S2-S3 Prepared |
S4 執行 |
S5-S7 資料指標 |
S8-S10 需要資料 |
S11-S12 Async |
|---|---|---|---|---|---|---|
| Ih | HY010 | HY010 | 24000 | 請參閱下一個表格 | HY010 | NS [c] HY010 [o] |
SQLSetPos （資料指標狀態）
| S5 Opened |
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 Async |
|---|---|---|---|---|---|---|
| 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。