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_close(DCULONG cnthd1, DCLONG flags)
(2) Purpose
Terminates character code conversion to release the area on the memory that contains a code mapping table allocated.
(3) Arguments set by UAPs
- cnthdl
Specify the handle of the control table acquired by the dc_clt_codeconv_open function for character code conversion.
- flags
Specify DCNOFLAGS.
(4) Return values
Return Value |
Value (decimal) |
Meaning |
DC_OK |
0 |
Normal termination |
DCCLTER_INVALID_ARGS |
-2501 |
A value set for the argument is invalid. |
DCCLTER_NO_BUFS |
-2504 |
Insufficient memory |
- 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 unless you first save the table using the CommuniNet code mapping utility after the installation of CommuniNet. Before using this function, save the 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 by the character code converter does not reflect changes made in a code mapping table 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.