Download Informix CLI Programmer`s Manual, Version 2.5

SQLDataSourceToDriver
Usage
The driver calls SQLDataSourceToDriver to translate all the data (result set
data, table names, row counts, error messages, and so on) that passes from
the data source to the driver. The translation shared library might not
translate some data, depending on the data type and the purpose of the translation shared library. For example, a shared library that translates character
data from one code page to another ignores all numeric and binary data.
The value of fOption is set to the specified value of vParam by calling SQLSetConnectOption with the SQL_TRANSLATE_OPTION option. It is a 32-bit value
that has a specific meaning for a given translation shared library. For
example, it might specify a certain character-set translation.
If the same buffer is specified for rgbValueIn and rgbValueOut, the translation
of data in the buffer is performed in place.
Important: Although cbValueIn, cbValueOutMax, and pcbValueOut are the
SDWORD type, SQLDataSourceToDriver does not necessarily support huge
pointers.
If SQLDataSourceToDriver returns FALSE, data truncation might have
occurred during translation. If pcbValueOut (the number of bytes available to
return in the output buffer) is greater than cbValueOutMax (the length of the
output buffer), then truncation occurs. The driver must determine whether
the truncation is acceptable. If truncation does not occur, the SQLDataSourceToDriver returned FALSE due to another error. In either case, a specific
error message is returned in szErrorMsg.
15-6
INFORMIX-CLI Programmer’s Manual