Show TOC

RfcOpenConnectionLocate this document in the navigation structure

Use

Opens a client connection to an SAP System. The connection parameters may contain the following name-value pairs:

client, user, password, lang, trace and additionally one of

  • Direct application server logon: ashost, sysnr.

  • Logon with load balancing: mshost, msserv, sysid, group.

msserv is only needed, if the service of the message server is not defined as sapms<SYSID> in /etc/services.

When logging on with SNC, user and password are to be replaced by snc_mode (0/1), snc_qop, snc_myname, snc_partnername, snc_lib.

When logging on with SSO Ticket, you can use mysapsso instead of

Use r and password or mysapsso2 instead of password.

Alternatively the connection parameters can be defined in the configuration file

sapnwrfc.ini. In this case you just pass the parameter dest=... and the

user credentials into RfcOpenConnection.

If the logon was ok, RfcOpenConnection returns a client connection handle, that can be used in RfcInvoke.

Otherwise the return value is NULL and errorInfo contains a detailed error description.

Start of the navigation path errorInfo Next navigation step code End of the navigation path will be one of:

  • RFC_INVALID_PARAMETER: One of the connection parameters was invalid.

  • RFC_COMMUNICATION_FAILURE: Problems in the network or network settings.

  • RFC_LOGON_FAILURE: Invalid user/password/ticket/certificate.

  • RFC_ABAP_RUNTIME_FAILURE: Problems in the SAP backend system.

Structure

RFC_CONNECTION_HANDLE SAP_API RfcOpenConnection (RFC_CONNECTION_PARAMETER const * connectionParams, unsigned paramCount, RFC_ERROR_INFO* errorInfo);