📄 fce4vb_u.txt
字号:
FTP Client Engine
Library for Visual Basic
(FCE4VB)
USERS MANUAL
Version 1.2
August 16, 1999
This software is provided as-is.
There are no warranties, expressed or implied.
Copyright (C) 1999
All rights reserved
MarshallSoft Computing, Inc.
Post Office Box 4543
Huntsville AL 35815
Voice : 256-881-4630
FAX : 256-880-0925
email : info@marshallsoft.com
web : www.marshallsoft.com
_______
____|__ | (R)
--+ | +-------------------
| ____|__ | Association of
| | |_| Shareware
|__| o | Professionals
--+--+ | +---------------------
|___|___| MEMBER
MARSHALLSOFT is a registered trademark of MarshallSoft Computing.
FCE4VB Users Manual Page 1
C O N T E N T S
Chapter Page
1.0 Introduction................................................3
1.1 User Support............................................5
1.2 ASP Ombudsman...........................................5
1.3 Installation............................................6
1.4 Uninstalling............................................6
2.0 Library Overview............................................7
2.1 Dynamic Link libraries..................................7
2.2 Compiling Programs......................................7
2.3 FCE4VB Class............................................7
3.0 Using the FCE Library.......................................8
4.0 Application Notes...........................................9
4.1 FTP Basics..............................................9
4.2 Auto Dial...............................................9
4.3 Key Codes...............................................9
5.0 Theory of Operation........................................10
6.0 Versions of FCE............................................11
6.1 Shareware Version......................................11
6.2 Student Version........................................11
6.3 Professional Version...................................11
7.0 Using FCE with Other Languages.............................12
8.0 Problems...................................................12
9.0 Example Programs...........................................13
10.0 Registration...............................................14
10.1 Professional Version..................................14
10.2 Student Version.......................................14
10.3 Updates...............................................14
11.0 Payment....................................................15
12.0 Legal Issues...............................................16
12.1 License...............................................16
12.2 Warranty..............................................16
13.0 Summary....................................................17
13.1 Revision History......................................17
13.2 FCE Function Summary..................................17
13.3 FCE Error Return Code List............................18
FCE4VB Users Manual Page 2
1.0 Introduction
FCE4VB is the easiest way to write FTP applications in Visual Basic!
FCE can be used for both anonymous and private FTP sessions.
The FTP Client Engine (FCE) is a library of functions providing
direct and simple control of the FTP protocol.
A simple interface allows connecting to a FTP server, navigating its
directory structure, listing files, sending files, deleting files,
and receiving files using the FTP protocol.
With FCE4VB, you can write GUI or console mode programs that easily:
(1) Connect to any FTP server.
(2) Get a list of files on the server.
(3) Navigate the server directories.
(4) Specify ASCII or BINARY transfer mode.
(5) Download files.
(6) Upload files.
(7) Delete files.
(8) Create and remove server directories.
FCE4VB supports all versions of Visual Basic.
Both Win16 and Win32 DLLs (Dynamic Link Libraries) are provided.
FCE4VB can be used with Windows 3.X, 95/98, and NT. The FCE4VB DLLs
(FCE16.DLL and FCE32.DLL) can also be used from any language (C/C++,
WORD, ACCESS, EXCEL, PowerBASIC Console Compiler, Delphi, Visual
FoxPro, Visual dBase, COBOL, Fortran, etc.) capable of calling the
Windows API.
When comparing FCE against our competition, note that:
(1) FCE4VB is a standard Windows DLL (NOT an OCX or ActiveX control)
and is much smaller than a comparable OCX or ActiveX control.
(2) Both WIN16 and WIN32 DLLs are included.
(3) FCE4VB does NOT depend on ActiveX or Microsoft Foundation Class
(MFC) libraries or similar "support" libraries.
(4) The WIN32 version of FCE is fully threadable.
(5) The FCE functions can be called from applications not capable of
using controls.
A C/C++ version (FCE4C) is also available. Versions of FCE for
Delphi (FCE4D) and PowerBASIC (FCE4PB) are in development (August
1999). But note that all versions will use the same DLLs.
FCE4VB Users Manual Page 3
1.0 Introduction (continued)
The following example demonstrates the use of the library functions:
+-------------------------------------------------------------------+
| |
| ' 32-bit VB code segment |
| |
| Dim Code As Long |
| ' attach FCE |
| Code = fceAttach(1, FCE_KEY_CODE) |
| If Code < 0 Then |
| Print "Error connecting" |
| Exit Sub |
| End If |
| ' connect to server |
| Code = fceConnect(0, "ftp.marshallsoft.com", |
| "anonymous", "msc@traveller.com") |
| ' change to proper directory |
| Code = fceSetServerDir(0, "pub/other") |
| ' set to ASCII xfer mode |
| Code = fceSetMode(0,ASC("A")) |
| ' download the file |
| Code = fceGetFile(0, "products.txt") |
| ' QUIT |
| Code = fceClose(0) |
| Code = fceRelease() |
| |
+-------------------------------------------------------------------+
In the example program above, fceConnect is called to connect to
the FTP server as user "anonymous" and password "msc@traveller.com".
The server directory is changed to "pub/other", the transfer mode is
set to ASCII, and the file "products.txt" is downloaded. Lastly, the
connection to the FTP server is closed and FCE is released.
Refer to the FCE4VB Reference Manual for individual function details.
FCE4VB Users Manual Page 4
1.1 User Support
We want you to be successful in developing your applications using
FCE4VB! We are committed to providing the best library that we can.
If you have any suggestions or comments, please let us know.
If you are having a problem using FCE4VB, email us at
support@marshallsoft.com
You can also reach us at 256-881-4630 between 7:00 AM and 7:00 PM CST
Monday through Friday. You can also often contact us on the weekend.
The latest versions of our products are available on our web site at
http://www.marshallsoft.com
and on our anonymous FTP site at
ftp://ftp.marshallsoft.com/marshallsoft
The MarshallSoft Computing newsletter "Comm Talk" is published
quarterly on our web site. It discusses various communications
problems and solutions using our products as well as related
information.
1.2 ASP Ombudsman
MarshallSoft Computing, Inc. is a member of the Association of
Shareware Professionals (ASP). ASP wants to make sure that the
shareware principle works for you. If you are unable to resolve a
shareware-related problem with an ASP member by contacting the member
directly, ASP may be able to help. The ASP Ombudsman can help you
resolve a dispute or problem with an ASP member, but does not provide
technical support for members' products. Please write to the ASP
Ombudsman at 157-F Love Ave., Greenwood, IN 26142 USA, FAX
317-888-2195, or send email to omb@asp-shareware.org.
FCE4VB Users Manual Page 5
1.3 Installation
(1) Unzip FCE4VB12.ZIP into a project directory.
(2) Run the installation command file INSTALL.BAT.
You're ready to run! Win16 programs (VB 3.0) end with "16", while
Win32 programs (VB 4.0, 5.0, & up) end with "32".
Note that the Windows registry is NOT modified.
1.4 Uninstalling
Uninstalling FCE4VB is very easy. FCE4VB does NOT modify the
registry. First, delete the FCE4VB project directory created when
installing FCE4VB. Second, delete FCE16.DLL and FCE32.DLL from your
Windows directory, typically C:\WINDOWS for Windows 3.1/95/98 or
C:\WINNT for Windows NT. That's it!
FCE4VB Users Manual Page 6
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -