Receive 

Purpose

Makes a one-way call to R/3, receiving export parameters and table data.

Syntax

RFC_RC Receive(char*& strException);

Return Value

The possible return codes are:

RFC_OK

The call was successfully completed and the values of the returned parameters were filled into the memory being supplied by the list of export parameter objects.

RFC_CLOSED

The connection was closed by the other end.

RFC_EXCEPTION

The callee has raised an exception. The string strException contains the name of the exception. No data were transported.

RFC_CALL

The callee has issued an RFC call to the caller of Receive. No data are transported. The call request must be handled by using the CRfcServerApp::Run before another call to Receive can be done.

Parameters

strException: A reference to a string, to be filled with error information when an RFC exception is encountered.

Exceptions

Throws const char* for memory exceptions.

Throws RFC_ERROR_INFO for Receive failure, matching these return codes in the C-API: RFC_SYS_EXCEPTION(local or remote RFC system raised an exception), RFC_FAILURE(internal error).

Description

Receive can only be called after a Call is issued. Before making this function call, make sure all necessary export and table parameters are added to the function object. Any values to be received via these parameters can be retrieved right after Receive.

Related Information

Call

CallReceive