The CRfcConnection Class 

Class Summary

The CRfcConnection class is defined in CRfcConn.h.

The CRfcConnection class manages information concerning logon to R/3, and is also responsible for making and terminating connections. A CRfcConnection object with a live connection is needed for any real-time interactions with R/3 through CRfcFunction objects.

Construction

CRfcConnection

Default constructor

CRfcConnection

Constructs a CRfcConnection object

Operations

Abort

Aborts the connection with an error message

Accept (Console Version)

Accept an incoming connection, console version

Accept (Windows Version)

Accept an incoming connection. Windows applications only

Clear

Close connection and clear user logon and connection information

Close

Closes the connection

ConnArgv

Command line parsing (32-bit only)

Connect

Opens the connection with load-balancing

Decrypt

Restore encrypted information stored in a text string

Encrypt

Encrypt information in a text string

FromHandle

Creates a new connection by using the RFC_HANDLE parameter

GetAttributes

Retrieves RFC attributes stored in the CrfcConnection object

GetCommandLineArgument

Returns the command line arguments in a character string

GetConnectInfo

Obtains connection information stored in the object

GetHandle

Obtains the connection handle stored in the connection object

GetR3Release

Obtains R/3 release version of the R/3 system

GetR3SystemInfo

Obtains R/3 system information by calling the RFC function module RFC_SYSTEM_INFO

GetR3SystemInfoCount

Returns the number of fields in the list of R/3 system information

GetR3SystemParameters

Calls RFC function RFC_GET_SAP_SYSTEM_PARAMETERS to obtain the R/3 release version

GetReleaseString

Returns a character string containing the release version of the R/3 system being connected to

GetSafeHandle

Obtains a verified, live connection handle

GetTraceLevel

Obtains the current trace level

GetUserInfo

Obtains user information stored in the object

IsR3AtLeast40A

Determines if the application server is running Release 4.0A or a later version of the R/3 System

Open

Opens the connection

R3SystemInfo (by field-name)

Returns R/3 system information by name of field

R3SystemInfo (by index)

Returns R/3 system information by index

ReadRegistry

Reads from Windows registry user and connection information; stores into connection object

SafeConnect

Opens the connection with load-balancing and user information verification

SafeOpen

Opens the connection with user information verification

SetConnectInfo

Sets connection information stored in the object

SetTraceLevel

Sets the current trace level

SetUserInfo

Sets user information stored in the object

WriteRegistry

Writes current user and connection information into Windows registry