Programming interface
4.1 Functions of the serial interface
SIMATIC 3964R protocol for Windows 9x/XP/7
20
Installation Manual, 01/2013, J31069-D0131-U001-A2-7218
ComGetVersion
comInt
ComGetVersion
(char *ver_string)
This function returns the version number of the DLL being used and an expanded version
string (if required).
Parameter
ver_string
Buffer for the expanded version string
No expanded version information if "NULL".
Return value
X
Version number (version x.y → x × 100 + y)
Notes
● The current version returns the value "450" for version 4.50 and the following expanded
version string "3964R / Lauf for Windows 95/NT/XP/7, version 4.50, November 2012".
● The transferred buffer area should have a minimum size of 100 characters.
ComString
comInt
ComString
(char *errs,
int error,
int typ)
This function returns an error text for the transferred error value.
Parameter
errs
Buffer for error text
error
Error number (result of a function of the user programming interface)
typ
possible error message:
•
COM_STR_OPEN = ComOpen
•
COM_STR_RDWR = ComRead or ComWrite
•
COM_STR_STATE = ComReadState or ComWriteState
•
COM_STR_EVENT = ComEnableEvent or ComDisableEvent
•
COM_STR_CLOSE = ComClose