Synopsis
int CacheCvtInA(CACHE_ASTRP extstr, 
                CACHE_ASTRP tblnam, 
                CACHE_ASTRP retval)
Description
Translates string with specified external character set encoding to the ASCII character string encoding used internally only in ASCII versions of Caché.
Arguments
where:
extstr The string in an external character set encoding to be translated (described using a counted character string buffer). The string should be initialized, for example, by setting the value to the number of blanks representing the maximum number of characters expected as output.
tblnam The name of the I/O translation table to use to perform the translation (a null string indicates that the default process I/O translation table name should be used).
retval Address of a CACHE_ASTR variable that will contain the counted ASCII string result.
Return Values
CacheCvtInA Return Values
CACHE_CONBROKEN Connection has been closed due to a serious error.
CACHE_ERRUNIMPLEMENTED Not available for Unicode.
CACHE_ERVALUE The specified I/O translation table name was undefined or did not have an input component.
CACHE_ERXLATE Input string could not be translated using the specified I/O translation table.
CACHE_NOCON No connection has been established.
CACHE_RETTRUNC Result was truncated because result buffer was too small.
CACHE_FAILURE Error encountered while trying to build translation data structures (probably not enough partition memory).
CACHE_SUCCESS Translation completed successfully.