File Transfer Protocol Control

Transfer files between a local and remote system and perform common file management functions on the server.

Reference

Control Information

Object Name FtpClientCtl.FtpClient
File Name CSFTPAX6.OCX
Version 6.0.6000.0
ProgID SocketTools.FtpClient.6
ClassID 270760C1-9744-4747-B039-5C1555FBBB3A
Threading Model Apartment
Help File CST60CTL.CHM
Dependencies None
Standard RFC 959, RFC 1579, RFC 2228

Remarks

The File Transfer Protocol (FTP) control provides a comprehensive interface which supports both high level operations, such as uploading or downloading files, as well as a collection of lower-level file I/O functions. In addition to file transfers, an application can create, rename and delete files and directories, search for files using wildcards, and so on. The control can be generally broken down into three distinct groups of functionality:

File Transfer
Methods which enable an application to upload and download files, as well as send and receive file data using memory buffers. For example, the GetFile method is used to download a file from the server and store the data in a file on the local system. On the other hand, the GetData method will download a file from the server and store the contents of that file in memory. This gives your program the flexibility of handling the data either on disk or in memory, depending on the best needs of your application. If your program needs to transfer multiple files at once, there are the GetMultipleFiles and PutMultipleFiles methods which will automatically download or upload two or more files in a single function call.

File Management
In addition to transferring files, the control can be used to manage files on the server. Methods are provided to delete, rename and move files between directories. For servers that support specific protocol extensions, advanced features such as getting or setting a remote file's modification time or access permissions are also supported. If a server supports site-specific commands, such as the ability to submit a file as job on the server, the control supports this by enabling you to send custom commands to the server and then process the information that it returns.

Directory Management
The control can be used to manage directories as well as files on the server. The application can open a directory and return a list of the files that it contains, as well as create new directories and delete empty ones. The control understands a number of different directory listing formats, including those typically used on UNIX and Linux based systems, Windows server platforms, NetWare servers and VMS systems.

This control supports secure file transfers using the standard SSL and TLS protocols. Both implicit and explicit SSL connections can be established, enabling the control to work with a wide variety of servers. A SocketTools Secure Visual Edition license must be purchased to use the security features in this control.

Requirements

This ActiveX control is supported on Windows 2000, Windows XP, Windows Server 2003, Windows Vista and Windows Server 2008. If you are using Windows 2000, it is required that you have Service Pack (SP4) installed. If you are using Windows XP, it is required that you have at least Service Pack 2 (SP2) installed and it is recommended that you install Internet Explorer 7.0. It is also recommended that all critical updates to the Windows operating system be installed.

The SocketTools Visual Edition components are compatible with any development tool that fully supports COM (Component Object Model) and the ActiveX control specification. This includes Visual Studio 6.0, Visual Studio .NET 2003, Visual Studio 2005 and Visual Studio 2008. If you are using Visual Basic 6.0 or Visual C++ 6.0, it is required that you have Service Pack 6 (SP6) installed. If you are using Visual Studio .NET 2003 or Visual Studio 2005, it is recommended that you install Service Pack 1 (SP1). In all cases, it is recommended that you have the current updates for your development tools installed.

Distribution

When you distribute an application that uses this control, you should install the appropriate file in the Windows system directory. ActiveX controls must be registered on the target system by the installation program before they can be used by an application.


Copyright © 2008 Catalyst Development Corporation. All rights reserved.