Function sapnwrfc::binding::RfcGetTable [] [src]

pub unsafe extern "C" fn RfcGetTable(
    dataHandle: DATA_CONTAINER_HANDLE,
    name: *const SAP_UC,
    tableHandle: *mut RFC_TABLE_HANDLE,
    errorInfo: *mut RFC_ERROR_INFO
) -> RFC_RC

Returns a handle to a table.

The field specified by name must be of type RFCTYPE_TABLE. If that field has not yet been accessed/filled previously, a new empty structure is created from the metadata of the parent data container ("dataHandle") and returned. \warning The memory of that data container will be released, when the parent container gets destroyed. So don't destroy the returned table handle, nor continue to use it, after the parent has been destroyed!

\in dataHandle A data container (function handle, structure handle or table handle). If dataHandle is a table handle, the function will read the field value of the current row. \in *name The name of the field to read. \out *tableHandle A handle to the sub-table. \out *errorInfo Field does not exist, is of wrong type or out of memory. \return RFC_RC