fill_sqlda_ex Function

Allocates space for each variable described in each descriptor of sqlda, and assigns the address of this memory to the sqldata field of the corresponding descriptor.

Syntax

struct sqlda * fill_sqlda_ex( struct sqlda * sqlda , unsigned int flags);

Parameters

sqlda – A pointer to a SQLDA structure.
flags – 0 or FILL_SQLDA_FLAG_RETURN_DT_LONG

Returns

sqlda if successful and returns NULL if there is not enough memory available.

Remarks

Enough space is allocated for the database type and length indicated in the descriptor.

The SQLDA should be freed using the free_filled_sqlda function.

One flag bit is supported: FILL_SQLDA_FLAG_RETURN_DT_LONG. This flag is defined in sqlca.h.

FILL_SQLDA_FLAG_RETURN_DT_LONG preserves DT_LONGVARCHAR, DT_LONGNVARCHAR and DT_LONGBINARY types in the filled descriptor. If this flag bit is not specified, fill_sqlda_ex converts DT_LONGVARCHAR, DT_LONGNVARCHAR and DT_LONGBINARY types to DT_VARCHAR, DT_NVARCHAR and DT_BINARY respectively. Using DT_LONGxyz types makes it possible to fetch 32767 bytes, not the 32765 bytes that DT_VARCHAR, DT_NVARCHAR and DT_BINARY are limited to.

fill_sqlda( sqlda ) is equivalent to fill_sqlda_ex( sqlda, 0 ).