OpenTP1 Version 7 TP1/Client User's Guide TP1/Client/W, TP1/Client/P
TP1/Client/W DLL or TP1/Client/P DLL
#include <dcvclt.h>
DCLONG dc_clt_codeconv_open(char CLTFAR *defpath,
DCULONG CLTFAR *cnthd1,DCLONG flags)
(2) Purpose
Starts character code conversion to allocate a code mapping table to be used in the memory.
(3) Arguments set by UAPs
- defpath
Specify NULL.
- cnthdl
Specify a pointer to an area for receiving the handle of a control table to be used for character code conversion.
- flags
Specify the conversion method.
- DCNOFLAGS
- Performs conversion by operations without using a code mapping table.
- DCCLT_CNV_CommuniNet
- Links with CommuniNet for conversion.
(4) Argument for which a value is returned
- cnthdl
This argument returns the handle of a character code conversion control table allocated in the memory.
(5) Return values
Return Value |
Value (decimal) |
Meaning |
DC_OK |
0 |
Normal termination |
DCCLTER_INVALID_ARGS |
-2501 |
The value set for the argument is invalid. |
DCCLTER_NO_BUFS |
-2504 |
Insufficient memory size |
DCCLTER_NOFILE |
-2557 |
A code mapping table is not found. |
DCCLTER_NOT_SUPPORTED |
-2558 |
This value means that using the code mapping table is not supported. This value is also returned when the code mapping table has never been saved using the CommuniNet code mapping utility after the installation of CommuniNet. |
DCCLTER_FILE_IO |
-2559 |
An I/O error occurred in the code mapping table. |
- The use of this function requires a CommuniNet code mapping table. Before using this function, create a code mapping table using the CommuniNet code mapping utility.
- You cannot use a code mapping table using the CommuniNet code mapping utility unless you first save the table after the installation of CommuniNet. Before using this function, save a code mapping table using the CommuniNet code mapping utility.
- The filename of a CommuniNet code mapping table must be CMAPEX.TBL. Store the code mapping table under a Windows directory before using this function.
- The processing of the character code converter does not reflect the changes in the contents of a code mapping table made by the CommuniNet code mapping utility during the use of this function.
- This function does not save error logs and UAP trace information.
- Issue the function for starting character code conversion (dc_clt_codeconv_open()) only once for code conversion (dc_clt_codeconv_exec()). Do not issue the function for starting character code conversion more than once to prevent memory shortage. If you issue two or more functions, issue one function for terminating character code conversion (dc_ctl_codeconv_close()) for each of the issued functions.
All Rights Reserved. Copyright (C) 2006, 2009, Hitachi, Ltd.