dbtxptr

Returns the value of the text or image pointer for a column in the current row.

Syntax

LPCDBBINARY dbtxptr (
PDBPROCESS dbproc,
INT column );

Arguments

dbproc

Is the DBPROCESS structure that is the handle for a particular workstation/ Microsoft® SQL Server™ process. It contains all the information that DB-Library uses to manage communications and data between the workstation and SQL Server.

column

Is the number of the column. The first column in a table is number 1. For further information, see dbadata.

Returns

A DBBINARY pointer to the text or image pointer for the column. This pointer can be NULL.

Remarks

Every database column of type SQLTEXT or SQLIMAGE has an associated text pointer that uniquely identifies the text or image value. Use this text pointer with dbwritetext. Call dbtxptr only after dbnextrow or dbgetrow has returned REG_ROW.

Caution Do not modify this identifier in any way. Modifying the identifier can cause unpredictable results.

Text pointers are of fixed length and can be NULL when the text or image value is NULL.

See Also