|
Summary
Connect to FTP server.
Syntax
| Boolean Connect (Host, User, Password, Account) |
|
Host |
String |
|
User |
String |
|
Password |
String |
|
| Account |
| String (note that this is not used by most FTP servers) |
Description
The Connect method establishes a connection to the FTP server.
The Connect method takes a host name (Host), a user name (User), a password (Password) and an account (Account) as its parameters and returns a boolean.
Host must be the name or internet address (in dotted decimal notation) of the FTP server. User and Password must contain a valid user name and password to complete the
login process. Some servers also require that Account contain the name of an account for the user. If the server does not require the name of an account for the user, then Account
can be set to an empty string.
If a connection is successfully established, then the method returns True; otherwise, it returns False. The application should ensure that the method was successfully executed by checking the return
value. The method also sets the LastResult property. The value of the LastResult property can be checked to determine if any error occurred.
If the connection can be established, then the OnConnect event will be fired. If the connection cannot be established, then the OnError event will be fired. These events will occur before the next
statement (i.e. the statement following the call to the Connect method) is executed. The application should set a flag in the OnConnect and OnError events, so that it can determine if the session has
been established or not. In addition, the application may want to display an error message in the OnError event to inform the user that the connection has not been established. Please check the
reference page of the OnError event for a complete listing of error codes.
Calling this method is equivalent to setting the Action property to ACTION_CONNECT.
Example
Result = FTPClient.Connect ("speedy.distinct.com", "santa", "north pole", "sc001d")
If Result = False Then
MsgBox "Unable to connect to server", 64,
"Sample Program"
End If
Note
File transfer must NOT be initiated until this method has returned TRUE.
| 
