See also | Examples |
Runs a DataBasic subroutine on the Reality account to which the cNISRbRscLink object is connected.
Namespace: NISRbDataLink
Assembly: NIS RemoteBasic Objects (in NISRbDataLink.dll)
instance.CallSubroutine(funcName, numParams, {parameter, mode{, parameter, mode{...}})
instance An instance of the cNISRbRscLink class.
funcName A String containing the name of a DataBasic subroutine that is available in the account specified in the object's Account property.
numParams An Integer value from 0 to 20. This specifies the number of optional parameter/mode pairs supplied. If less than 0 or greater than 20, an eRscParamNo error is raised.
parameter A String containing an actual parameter to be passed to the DataBasic subroutine. If the parameter is used by the DataBasic subroutine to return a value (see mode below), parameter must be the name of a String variable.
mode A value of type RSCMode that specifies the direction in which the previous parameter should be passed – one of the following values:
Value | Operation |
---|---|
RSCMode.ParamIgnore | Ignore the parameter. Use where the DataBasic parameter is used only to return a value, but that value will not be used in the Windows program. |
RSCMode.ParamIn | Parameter passed to DataBasic. Use to pass a value required by the DataBasic subroutine, where either no value is returned, or the value returned will not be used in the Windows program. |
RSCMode.ParamOut | Parameter returned by DataBasic. Use where the DataBasic parameter is used only to return a value which is required by the Windows program. parameter must be the name of a String variable. |
RSCMode.ParamInOut | Parameter passed to and from DataBasic. Use to pass a value required by the DataBasic subroutine, where the parameter is also used to return a value that is required by the Windows program. parameter must be the name of a String variable. |
The default if the mode parameter is omitted is RSCMode.ParamInOut.
Careful use of the mode parameter can reduce network traffic. Refer to the documentation for the DataBasic subroutine concerned to find out which mode you should use for each parameter. RSCMode.ParamInOut is always guaranteed to work, but might result in data being transferred unnecessarily.
Up to 20 parameters can be passed to the called DataBasic subroutine. Refer to the documentation for the DataBasic subroutine concerned for details of the parameters required.
Remote Basic ActiveX Control
cNISRbRscLink Members
cNISRbRscLink.OpenLink Method
cNISRbRscLink Errors