ODBC_SQLSetCursorName

4D - Documentation   Français   English   German   4D ODBC PRO, Command Theme List   4D ODBC PRO, Command Alphabetical List   Back   Previous   Next

version 2004


ODBC_SQLSetCursorName (stmtID; cursorName) Longint

ParameterTypeDescription
stmtIDLongintStatement ID
cursorNameStringName of the cursor to set
Function resultLongintReturns the result of the MS ODBC API function
SQLSetCursorName

Description

The ODBC_SQLSetCursorName command associates a cursor name with an active statement. If this command is not called, the driver generates cursor names needed for SQL statement processing.

For efficient processing, the cursor name should not include any leading or trailing spaces, and if the cursor name includes a delimited identifier, the delimiter should be positioned as the first character in the cursor name. Cursor names are used only in positioned update and delete statements and should not exceed 18 characters in length.

If the SQL statement is a SELECT statement and if you set a cursor name with a statement, then the driver uses the specified cursor. Otherwise, the driver generates a cursor name.

stmtID is a valid statement ID returned by ODBC_SQLAllocStmt.

cursorName is the name of the cursor that was previously set by ODBC_SQLSetCursorName.

For more information, please see the SQLSetCursorName function in the MS ODBC API at http://msdn.microsoft.com/library/en-us/odbc/htm/odbcsqlsetcursorname.asp.

Function Results

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR, or SQL_INVALID_HANDLE.

Example

See the example for the ODBC_SQLGetCursorName command.

See Also

ODBC_SQLExecDirect, ODBC_SQLGetCursorName.


4D - Documentation   Français   English   German   4D ODBC PRO, Command Theme List   4D ODBC PRO, Command Alphabetical List   Back   Previous   Next