Product Documentation

FairCom Direct SQL for C and C++

Previous Topic

Next Topic

ctsqlGetTime

Retrieve the time field.

Declaration

CTSQLRET ctsqlGetTime(pCTSQLCURSOR hCursor, INTEGER colnumber, SQLTIME* buffer)

Description

ctsqlGetTime() retrieves the value of a time field, given its cursor and column.

  • hCursor cursor handle.
  • colnumber column number.
  • buffer the buffer that will store the field data.

Return

ctsqlGetTime() returns CTSQLRET_OK on success.

Prior to V12, a call to this function, or similar ctsqlGet*() functions for other data types, would fail with SQL_ERR_BADARG if the column value was a SQL NULL. These functions now return CTSQL_NULLRESULT if the data value is a SQL NULL. This change does not apply to ctsqlGetBinary or ctsqlGetBlob. Note: This modification is a Compatibility Change.

Symbolic Constant

Explanation

SQL_ERR_BADARG

Bad arguments

Note:

DSQL no longer allows using ctsqlGetChar() to retrieve long variable columns.

See Also

ctsqlGetBytes(), ctsqlGetNChar(), ctsqlGetNumeric(), ctsqlGetSmallInt(), ctsqlGetInteger(), ctsqlGetReal(), ctsqlGetFloat(), ctsqlGetDate(), ctsqlGetMoney(), ctsqlGetTimeStamp(), ctsqlGetTinyInt(), ctsqlGetBinary(), ctsqlGetBit(), ctsqlGetBigInt(), ctsqlGetBlob()

TOCIndex