Related Syntax		Other Library Functions

function

SQLSetCursorName

Library: omodbc - low-level ODBC support Include: omodbc.xin

Return type: Integer Returns:        An SQL return code. The following values may be returned: SQL_SUCCESS (the cursor name was successfully associated with the active statement). SQL_SUCCESS_WITH_INFO (the cursor name was successfully associated with the active statement, but a message was issued). SQL_ERROR (an error occurred). SQL_INVALID_HANDLE (the handle is invalid).

Declaration

  define external integer function SQLSetCursorName
     (  read-only SQL_handle_type StatementHandle,
        value stream CursorName,
        value integer NameLength )

Associates a cursor name with an active statement. If an application does not call SQLSetCursorName, the driver generates cursor names, as needed, for SQL statement processing.

Input arguments:

• StatementHandle.
• CursorName. For efficient processing, the cursor name should not include any leading or trailing spaces and, if the name includes a delimited identifier, the delimiter should be positioned as the first character in the name.
• NameLength. The length of cursor name.