RequestVRFCLogonEx

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

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

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.

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 already exists, and if so, asks the user whether this connection should be used.

Function Prototype:

VRFCLoginID SAP_API RequestVRFCLogonEx(HWND hWnd
VRFCService_HANDLE hAppl,
VRFCService_CONNECTMODE c_mode,
char SAP_FAR* destination = NULL,
char SAP_FAR* hostname = NULL,
long sysnr = -1,
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

VRFCLoginID

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

hostname

R/3 application server name; optional

long

systemnumber

R/3 System number; optional

LPSTR

gateway_host

R/3 Gateway host name; optional

LPSTR

gateway_service

R/3 Gateway service name, 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)