dbcursorcolinfo
Returns information about the specified column of a client cursor, transparent server cursor, or explicit server cursor.
Syntax
RETCODE dbcursorcolinfo (
PDBCURSOR hcursor,
INT column,
LPSTR colname,
LPINT coltype,
LPDBINT collen,
LPINT usertype );
where
-
hcursor
-
Is the cursor handle created by dbcursoropen.
-
column
-
Is the column number in the cursor for which information is to be returned. The first column is number 1.
-
colname
-
Is a pointer to the program variable that will contain the name of the column. The program variable should be large enough to accommodate the column name. If colname is set to NULL or -1, the column name is not returned.
-
coltype
-
Is a pointer to the program variable that will contain the datatype token of the column. If coltype is set to NULL or -1, the column datatype is not returned.
-
collen
-
Is a pointer to the program variable that will contain the maximum length of the column, in bytes. If collen is set to NULL or -1, the maximum column length is not returned.
-
usertype
-
Is a pointer to the program variable that will contain the user-defined datatype of the column. If usertype is set to NULL or -1, the column user-defined datatype is not returned.
Returns
SUCCEED or FAIL.
Remarks
Call dbcursorcolinfo after dbcursoropen returns a valid cursor handle. The dbcolinfo function returns more detailed information about a cursor column.
See Also
dbcolinfo, dbcursor, dbcursorbind, dbcursorclose, dbcursorfetch, dbcursorinfo, dbcursoropen