OpenTP1 Version 7 TP1/Client User's Guide TP1/Client/W, TP1/Client/P
4.1 Notes on using functions
The following are notes on using functions:
- We recommend that you use the _s version of functions (dc_xxx_xxx_s), which can operate in a multi-thread environment. Note, however, that some TP1/Client program products might not support the _s version of functions. For the support status of the _s version of functions (dc_xxx_xxx_s), see the Release Notes.
- In TP1/Client/W, you do not need to specify the CLTFAR pointer (even though specifying the pointer does not result in any problem). However, in TP1/Client/P, you must specify the CLTFAR pointer. How the pointer operates is defined in dcvclt.h.
- For the non-_s version of functions (dc_xxx_xxx) in TP1/Client/P, you can specify either the CLTFAR pointer or the far pointer without any problems.
- The _s version of a function (dc_xxx_xxx_s) and the non-_s version of the corresponding function (dc_xxx_xxx) do not have the same number of arguments. In a multi-thread environment, you must use the _s version. The non-_s version of a function (dc_xxx_xxx) will not correctly operate in a multi-thread environment. Although the character code converter provides the non-_s version of functions only, the functions will operate correctly in a multi-thread environment.
All Rights Reserved. Copyright (C) 2006, 2009, Hitachi, Ltd.