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