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. Enough space is allocated for
the database type and length indicated in the descriptor. Returns sqlda if successful and returns the null pointer if there is not enough memory available.
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 ).