View source for RPC HELP DLL GuideLines CPP Execute RPCs

[[RPC_Broker_Help| RPC Broker Help Home]]

[[RPC_HELP_Other_DLL_Interface_List|DLL Interface Home]]
<h2>C++: Execute RPCs</h2>
If you can make a successful connection to the RPC Broker VistA M Server, and create an application context, you can execute any [[RPC_HELP_RPCs|RPC]]s registered to your context.
	
To execute [[RPC_HELP_RPCs|RPC]]s from your C++ program:

'''1.''' Create a character buffer large enough to hold your [[RPC_HELP_RPCs|RPC]]'s return value:

    char Value [1024];

'''2.''' Set the [[RPC_HELP_TRPCBroker_RemoteProcedure|RemoteProcedure]] property of the [[RPC_HELP_TRPCBroker|TRPCBroker]] component to the [[RPC_HELP_RPCs|RPC]] to execute:

    RPCInst.RPCBPropSet("RemoteProcedure","XWB GET VARIABLE VALUE");

'''3.''' Set the [[RPC_HELP_TRPCBroker_Param|Param]] values for any parameters needed by the [[RPC_HELP_RPCs|RPC]]. In the following example, one TRPCBroker [[RPC_HELP_TRPCBroker_Param|Param]] node is set (the equivalent of [[RPC_HELP_TRPCBroker_Param|Param]][0]):

'''3a.''' A value of 0 for parameter 1 denotes the integer index of the [[RPC_HELP_TRPCBroker_Param|Param]] node being set ([[RPC_HELP_TRPCBroker_Param|Param]][0]).

'''3b.''' A value of reference for parameter 2 denotes the setting for the equivalent of [[RPC_HELP_TRPCBroker_Param|Param]][0].[[RPC_HELP_TParamRecord_PType_Property|PType]]. This uses the enumerated values for [[RPC_HELP_TParamRecord_PType_Property|PType]] declared in the header file.

'''3c.''' A value of "DUZ" for parameter 3 denotes that the equivalent of [[RPC_HELP_TRPCBroker_Param|Param]][0].Value is "DUZ":

    RPCInst.RPCBParamSet(0, reference, "DUZ");

'''4.''' Use the [[RPC_HELP_DLL_ExportFN_RPCBCall|RPCBCall]] method to execute the [[RPC_HELP_RPCs|RPC]]:

    RPCInst.RPCBCall(Value);
	
The return value from the [[RPC_HELP_RPCs|RPC]] is returned in the first parameter (in this case, the Value character buffer).