CAPIHandleStatus

Public Function CAPIHandleStatus(ByVal dvref As Integer,
                                                       ByVal cmd As String,
                                                       Optional ByVal dimval As Integer = 0) As String

This function handles STATUS type device controls.

If the return from this procedure is an empty string, then the call was successful.  If the return value is not an empty string, then it will contain information about the failure of the call.

dvref - This is the unique device reference number (dv.ref)

cmd - This is the command code obtained from the control object (ControlValue) which is a string value.  The value of this is either ON, OFF, or DIMBF.

dimval - If CMD (ControlValue) is DIMBF, then ControlData from the control object contains the integer value to pass to this parameter.