Connects to a specified SAP application server. Note that using It_NewServerConnection does not take advantage of load balancing as provided when you use It_NewGroupConnection. When using It_NewServerConnection you specify a particular server machine to connect to.


HANDLE DLEX It_NewServerConnection (const char *id, const char *ms,
Const char *router, const char *server, long flags);



SAP System ID that identifies the SAP System. The list of SAP Systems is retrieved from the file SAPMSG.INI.


Hostname of the message server. The message server routes the service to various application servers. This message server will provide a list of the currently available application servers that are running on the selected system. Each SAP System provides one message server. This information is stored in the file SAPMSG.INI.


Destination router used to connect to the message server as well as to the listed application servers. The list of available SAP routers is retrieved from the file SAPROUTE.INI.


The IP address of the application server to connect to.

If you want to connect to an application server from a list of currently available servers in a system, you can obtain this list of servers by using the It_ServerLookup function. It_ServerLookup returns the IP addresses of the available servers.


Flags to control the connection operation.

Flags also allow you to specify how the coordinates of controls on the screen are expressed (affects all events associated with the connection).

The same flags are used in all of the connection functions.

Return Value

Returns the handle to an SAP Automation GUI session if successful, otherwise returns FALSE.

See Also

It_Login, It_Logoff, It_NewConnection, It_NewGroupConnection, It_ServerLookup