RoboSendCommand        Method to send a script command to Robo-FTP

Top  Previous  Next

 

Overview

Method to send a script command to Robo-FTP.

 

C++ Definition

long RoboSendCommand( CString strCommand, long nTimeout )

 

VB Definition

RoboSendCommand( Command As String, Timeout As Long ) As Long

 

C# Definition

Int RoboSendCommand( CString strCommand, Int nTimeout )

 

VB.NET Definition

RoboSendCommand( Command As String, Timeout As Integer ) As Integer

 

Return Value

The numeric result code returned by Robo-FTP after the execution of a script command.

 

Returns >= ROBO_ERROR_FROM_ROBOFTP if the command was executed successfully by Robo-FTP. This value corresponds to one of Robo-FTP's script command result codes.

Returns ROBO_ERROR_CMD_IN_PROGRESS if the command is non-blocking and the command has been successfully initiated.

Returns ROBO_ERROR_TIMED_OUT if the command timed out.

 

See COM/OLE Return Codes below for a complete list of possible return values.

 

Parameters

strCommand / Command

A string defining the Robo-FTP script command to perform.

 

To have Robo-FTP simulate line numbers in the log file, precede the command with #{number} and a space character. For example, #100 FTPLOGON would result in a simulated line number of 100 being associated with this command.

 

nTimeout / Timeout

A long specifying the period of time (10th of seconds) to wait for a blocking RoboSendCommand() to complete. The parameter is ignored when the RoboSendCommand() is non-blocking.

 

Remarks

The RoboStartSession() method must be called prior to calling RoboSendCommand(). This method blocks or returns immediately depending on the selection made in the RoboStartSession() method. If non-blocking is selected, the RoboCommandResult() event is fired upon completion.

 

If you send a conditional command (e.g., IFFILE or IFERROR) the conditional element of the command is evaluated and a TRUE/FALSE result is passed back but no actual branching action is taken.

 

For example, if the following script command is sent to Robo-FTP and the file exists Robo-FTP returns $ERROR_OLE_COMPARISON_TRUE; if file does not exist, the return value is $ERROR_OLE_COMPARISON_FALSE. The goto portion of the command is ignored since Robo-FTP really does not have a script file to branch within.

 

IFFILE "c:\Program Files\Robo-FTP\thisfile" goto found it

 

If script labels are sent, they are ignored.

 

See also: COM Programming Reference