ftpDisconnect (Function)

This function will disconnect from the FTP server. All references to the connection identification (ID) after this call is illegal.

The connection is closed by quitting the session - thus making sure that the user is correctly logged out.

Any file transfer in progress will be canceled.

For each ftpConnect(), there must be a corresponding call to ftpDisconnect(). This is also the case when the connection is closed from the FTP server side (see example below).  

Note:

Disconnection with no server communication capability will result in an unclosed session on the server.

Input:

ID : INT

The ID returned from ftpConnect.

Returns: INT

Declaration:

FUNCTION ftpDisconnect : INT;
VAR_INPUT
  ID     : INT;
END_VAR;

Example:

INCLUDE rtcu.inc
 
PROGRAM example;
VAR
  open : BOOL;
  host : STRING := "ftp.domain.com";
  usr   : STRING := "ftpuser";
  pwd   : STRING := "user pwd";
 
  id   : INT;
END_VAR;
 
  gsmPower(power := ON);
  gprsOpen();
 
BEGIN
 open := (ftpOpen() = 0);
IF open THEN
    id := ftpConnect(host := host, username := usr, password := pwd);
    .
    ...
    ftpDisconnect(id := id);
END_IF;
ftpClose();
END;
END_PROGRAM;