16.11.2 SQLCloseCursor
- Organization of this subsection
(1) Function
This ODBC function closes a cursor that has been opened by a specified statement handle and discards unprocessed results.
(2) Format
SQLRETURN SQLCloseCursor ( SQLHSTMT StatementHandle /* In */ )
(3) Arguments
- StatementHandle
-
Specifies a statement handle.
(4) Return value
This ODBC function returns SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR, or SQL_INVALID_HANDLE.
(5) SQLSTATE
This ODBC function returns one of the following SQLSTATE values:
|
SQLSTATE |
Description |
Remarks |
Returned |
|---|---|---|---|
|
01000 |
General warning |
-- |
N |
|
24000 |
Invalid cursor status |
No cursor has been opened by StatementHandle. |
Y |
|
HY000 |
General error |
-- |
N |
|
HY001 |
Memory allocation error |
The memory required to execute or complete the function has not been allocated for the HADB ODBC driver. |
N |
|
HY010 |
Function sequence error |
-- |
N |
|
HY013 |
Memory management error |
N |
|
|
HYT01 |
Connection timeout expired |
N |
|
|
IM001 |
Driver does not support this function |
N |
- Legend:
-
Y: This SQLSTATE might be returned by the HADB ODBC driver.
N: This SQLSTATE is not returned by the HADB ODBC driver.
--: None