Function sapnwrfc::binding::RfcSubmitUnit [−] [src]

pub unsafe extern "C" fn RfcSubmitUnit(
    unitHandle: RFC_UNIT_HANDLE, 
    errorInfo: *mut RFC_ERROR_INFO
) -> RFC_RC

Executes a bgRFC unit in the backend.

Sends the bgRFC unit into the backend, where it will be executed synchronously or persisted in the given inbound queues and executed asynchronously by the bgRFC scheduler, depending on whether the unit type is 'T' or 'Q'. If the type is 'T', this function will wait until the unit is completely executed and then return the success or error information. If the type is 'Q', this function only inserts the unit into the specified queues and then returns. Processing of the unit in the backend system happens asynchronously. The return code of this function indicates, whether the unit could be persisted in the given queues successfully. In order to get information about the processing status of the unit, use RfcGetUnitState() at a later point.

Note: Despite the name "invoke", nothing is executed in the backend system, yet!

\in unitHandle A valid (unsubmitted) bgRFC unit, which shall be sent into the backend system. \out *errorInfo More details in case something goes wrong. \return RFC_OK, RFC_INVALID_HANDLE, RFC_MEMORY_INSUFFICIENT, RFC_COMMUNICATION_FAILURE