RPC HELP TRPCBroker lstCall Method

From VistApedia
Jump to: navigation, search

lstCall Method

Example

Applies to

   TRPCBroker component

Declaration

   procedure lstCall(OutputBuffer: Tstrings);

Declaration

This method, lstCall, executes a remote procedure on the VistA M Server and returns the results into the passed Tstrings- or TStringList-type variable, which you create outside of the call. It is important to free the Memory later. lstCall expects the name of the remote procedure and its parameters to be set up in the RemoteProcedure and Param properties respectively. The Results property is not affected by this call. If ClearParameters is True, then the Param property is cleared after the call finishes.

NOTE: See RPC Limits for information about the size of parameters and results that can be passed to and returned from the TRPCBroker component.

NOTE: Whenever the Broker makes a call to the VistA M Server, if the cursor is crDefault, the cursor is automatically changed to the hourglass symbol as seen in other Microsoft-compliant software. If the application has already modified the cursor from crDefault to something else, the Broker will not change the cursor.

NOTE: For a demonstration using the lstCall method, please run the BrokerExample.EXE located in the ..\BDK32\Samples\BrokerEx directory.