Siemens Simatic S7-1500 Function Manual page 122

User interfaces (API)
7.5 API ISimulationRuntimeManager
RemoteConnect()
Creates a new connection to a remote Runtime Manager or uses an existing connection to
create an IRemoteRuntimeManager interface.
Table 7- 68
Syntax
Parameters
Return values
Example C++
122
RemoteConnect() - Native C++
ERuntimeErrorCode RemoteConnect(
UINT8 in_IP3,
UINT8 in_IP2,
UINT8 in_IP1,
UINT8 in_IP0,
UINT16 in_Port,
IRemoteRuntimeManager** out_RemoteRuntimeManagerInterface
ERuntimeErrorCode RemoteConnect(
UIP in_IP,
UINT16 in_Port,
IRemoteRuntimeManager** out_RunTimeManagerInterface
);
•
UINT8 in_IP3:
First part of the IP address of the remote PC.
•
UINT8 in_IP2:
Second part of the IP address of the remote PC.
•
UINT8 in_IP1:
Third part of the IP address of the remote PC.
UINT8 in_IP0:
Last part of the IP address of the remote PC.
•
UIP in_IP:
IP address of the remote PC.
•
UINT16 in_Port:
The port that is open on the remote PC.
•
IRemoteRuntimeManager** out_RemoteRuntimeManagerInterface:
Pointer to a remote Runtime Manager interface pointer. The pointer must be in-
itialized with
ZERO
Runtime error code
SREC_OK
SREC_TIMEOUT
SREC_CONNECTION_ERROR
SREC_WRONG_ARGUMENT
SREC_WRONG_VERSION
ISimulationRuntimeManager* api = ZERO;
ERuntimeErrorCode result = Initialize(&api);
IRemoteRuntimeManager * client = ZERO;
if (result == SREC_OK)
{
RemoteConnect
result = api->
}
. The interface is created in the function.
Condition
The function is successful.
The function does not return on time.
The connection to the remote Runtime
Manager cannot be established.
IP, port or IInstance pointer is invalid.
The version of the API is not compatible
with Runtime.
See Compatibility during upgrade
(Page 31).
(192,203,145,144, 4444, &client);
Function Manual, 12/2017, A5E37039512-AB
S7-PLCSIM Advanced