Calling this routine can result in one or more upcalls to the application from any of the open API sessions known to this instance of the library.

If this call encounters an error, rapi_dispatch() returns a RAPI error code; otherwise, it returns 0. See RAPI error codes for a list of error codes.