InetFTPAutoRetrieve
int InetFTPAutoRetrieve (const char *FTPServer, const char *userName, const char *password, const char *localFile, const char *remoteFile, int transferType);
Purpose
Transfers a file from a remote FTP server to the local machine.
This high–level function logs in, changes directories, transfers the file, and logs out. The function closes the connection before it returns.
 |
Note You might need to use the lower–level functions to avoid errors if your application runs behind a firewall. |
Parameters
| Input | ||
| Name | Type | Description |
| FTPServer | const char * | The name or IP address of the remote machine. The remote machine must be running an FTP server on the standard FTP server port (21). If the FTP server is using a non-standard port, then you can specify the port using the syntax address:port. |
| userName | const char * | The user name to use when logging in to the FTP server. |
| password | const char * | The password to use when logging in to the FTP server. |
| localFile | const char * | The pathname of the destination file on the local machine. The path can be absolute or relative to the current working directory on the local machine. If the file already exists, it is overwritten. |
| remoteFile | const char * | The pathname of the remote file to retrieve. The path can be absolute or relative to the current working directory on the remote machine. |
| transferType | int | The mode in which the file is to be transferred. The following modes are valid:
|
Return Value
| Name | Type | Description |
| result | int | Return value indicating whether the function was successful. A negative number indicates that an error occurred. |
Additional Information
Library: Internet Library
Include file: cvintwrk.h
LabWindows/CVI compatibility: LabWindows/CVI 7.1 and later
Example
Refer to internet\simpftp\simpftp.cws for an example of using the InetFTPAutoRetrieve function.