Ts_Set_Ringindicator - Siemens SIMATIC S7 Operating Instructions Manual

SIEMENS AG

ts_set_ringindicator

The function ts_set_ringindicator initialises the sub-ordinate system for
receiving calls, establishing the connection and reporting (Ring indication).
A connection which is being established because of an incoming call is
signalled by means of a Windows message.
The following parameters are transferred:
• • • • ModemName
Name of the modem to be used for the ring indication, can be selected in
system control / modem
• • • • NumberOfRings
Number of rings until the modem replies.
• WindowHandle
Here it is possible to transfer a window handle. If the handle is valid, the
calling application is advised as to whether the connection has been
estalblished positively or negatively by means of a Windows message.
If the WindowHandle NULL (ZERO) is transferred, it is possible to recognize
a successful connection by means of the cyclic structure of the ts_read_info
function.
• Message
Message which is sent to the window when the connection has been
established.
• wParam
Parameters for the message.
• res1
reserved, must be set to NULL.
In the event of a valid WindowHandle messages with
PostMessage(Message,wParam,lParam) are transmitted. In this instance
lParam has the following meaning:
TS_CONNECTED = 1
In order to end the ring indication call the function with ModemName=NULL
(ZERO).
If there were no errors, the function supplies 0 as the return value otherwise an
error message which can be evaluated in accordance with the error table (see
error_message).
Toolbox for Data Link PGs/PCs to SIMATIC S7
connection established
67
PRODAVE S7