Ts_Dial - Siemens SIMATIC S7 Operating Instructions Manual

SIEMENS AG

ts_dial

The function ts_dial dials a remote station via the modem and establishes the
connection to the TS-Adaptor. When access protection is activated the
password is checked by the TS-Adaptor and the TS-Adaptor may ring back, if
required.
The following parameters are transferred:
• • • • ModemName
Name of Modem to be used, can be selected in system control / modems
• • • • Location
Name of Modem location, can be selected in system control / modem / dial
parameters
• • • • TelNo
Telephone number, which is dialled by the connected modem.
The telephone number must be transferred in canonical format:
+ CountryCode Space [area code Space] Tel.Nr. | SubAddress(ISDN) ^
Name(ISDN)
z.B.: +49 0711 137 3969
maximum amount of characters to be input is 31.
• • • • UserName
Specifiy UserName parameterised in TS Adaptor to be called.
Maximum amount of characters to be input is 8.
• • • • Password
Specify password parameterised in TS Adaptor to be called.
Maximum amount of characters to be input is 8.
• WindowHandle
Here it is possible to transfer a window handle. If the handle is valid, the
ts_dial function is processed asynchronously, i.e. 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, the function is processed
synchronously, i.e. the function does not return until after the connection has
been established or the timeout has elapsed.
• Message
Message which is sent to the window when the connection has been
established or the timeout has elapsed.
• wParam
Parameters for the message.
Toolbox for Data Link PGs/PCs to SIMATIC S7
63
PRODAVE S7