Puts the new value of a text timestamp into the specified column of the current row in the DBPROCESS.
RETCODE dbtxtsput (
PDBPROCESS dbproc,
LPCDBBINARY newtxts,
INT colnum );
SUCCEED or FAIL.
Every database column of type SQLTEXT or SQLIMAGE has an associated text timestamp, which is updated whenever the column’s value is changed. Use the text timestamp with dbwritetext to ensure that one user doesn’t inadvertently overwrite another’s modifications to the same value in the database. It is returned to the DBPROCESS when a Transact-SQL SELECT statement is performed on a SQLTEXT or SQLIMAGE column and can be examined by calling dbtxtimestamp. Call dbtxtsput only after dbnextrow or dbgetrow has returned REG_ROW.
After each successful dbwritetext operation (which can include a number of calls to dbmoretext), SQL Server sends the updated text timestamp value back to DB-Library. The dbtxtsnewval function allows the application to get this new timestamp value. The application can then use dbtxtsput to put the new timestamp value in the DBPROCESS row buffer for future access through dbtxtimestamp. This is particularly useful when the application is buffering result rows and does not need the new timestamp immediately.
dbmoretext | dbtxtimestamp |
dbreadtext | dbwritetext |