RequestRFCGroupLogonEx

This function is only valid for SAP R/3 Release 3.0C onwards.

This function provides a logon to the R/3 System. The function provides dialogs for filling in the missing login parameters. It is also possible, however, to logon without using a dialog if all parameters are provided. The difference between this function and the other logon function is that the application developer can provide a groupname instead of a single host as the application server.

In case only the system parameters are entered, a shorthand dialog appears which only provides the user parameters.

If destination, client and username are all provided, the Visual RFC Service Provider checks the already-established connections in order to determine if such a connection exists already. If so, it asks the user whether this connection should be used.

This function replaces the RfcOpen function in the RFC API used in conjunction with the new mode RFC_MODE_VERSION_3.

Function Prototype:

RFC HANDLE SAP_API RequestRFCGroupLogonEx(HWND hWnd,
VRFCService_HANDLE hAppl,
VRFCService_CONNECTMODE c_mode,
char SAP_FAR* destination = NULL,
char SAP_FAR* groupname = NULL,
char SAP_FAR* messageserver = NULL,
char SAP_FAR* client = NULL,
char SAP_FAR* user = NULL,
char SAP_FAR* password = NULL,
char SAP_FAR* language = NULL,
long trace = 0,
long dialog = 0)

Parameter Description

Type

Parameter Name

Description

RFC_HANDLE

return value

Connection handle, identifies the RFC connection established by this function

HWND

hWnd

Handle to the parent window can be NULL

VRFCService_HANDLE

hAppl

Application identifier

VRFCService_CONNECTMODE

c_mode

This parameter determines if the connection should be established with or without a dialog, and is only valid if all parameters are given

LPSTR

destination

R/3 System name; optional

LPSTR

groupname

R/3 application server group, used for load balancing; optional

LPSTR

messageserver

R/3 message server name which provides access to the chosen R/3 System; optional

LPSTR

client

client name, optional

LPSTR

user

R/3 user name; optional

LPSTR

password

R/3 password, optional

LPSTR

language

R/3 language, optional

long

trace

Debugging information, optional

long

dialog

if this parameter is set != 0, the RFC with dialog is used (e.g. the SAPGUI is called to display)