BOOL NewGroupConnection(LPCTSTR Id, LPCTSTR HostName, LPCTSTR Router, LPCTSTR group, 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. 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.


A group from a list of defined Groups in the system. This group is used to logon to an arbitrary application server in this Group. The group is based on load balancing. For example, group can be PUBLIC or JAPANESE, If the user does not know which group he wants to logon, he could use an empty string for this argument. The system will pick one automatically to make the connection.


Flags to control various aspects of the connection operation.

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

Each of the flags is based on a GUI Library connection flag.

Return Value

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


This is used to connect with R3 using GROUP information (load balancing).