fce4vb_u.txt

建设银行帐户管理系统

      Several example programs are included in FCE4VB. Separate versions
      for Win16 (FCEVER16, GETPRO16, WINFTP16) and Win32 (FCEVER16,
      GETPRO16, WINFTP16) are included.

      There is also an example program (hello32) which uses the VB class
      "fceClass".

      Each example program (except Hello32) comes with a VB makefile.
      WIN16 makefile names end with "16.MAK" (eg: FCEVER16.MAK) while
      WIN32 makefiles end with "32.MAK" (eg: FCEVER32.MAK).

      Before writing your own programs, compile and run the example
      programs.

      9.1 FCEVER

      The first example program is the program FCEVER (FCE Version) which
      displays the FCE library version number and registration string. The
      project makefiles are:

         FCEVER16.MAK : for VB 3.0.
         FCEVER32.MAK : for VB 4.0 and above.

      9.2 WINFTP

      WINFTP is an example FTP application which can be used to connect to
      a FTP server and upload, download, and delete files. See WINFTP.TXT
      for more details. The project makefiles are:

         WINFTP16.MAK : for VB 3.0.
         WINFTP32.MAK : for VB 4.0 and above.

      9.3 GETPRO

      GETPRO is a example program that connects to the MarshallSoft
      FTP server at ftp://ftp.marshallsoft.com and downloads PRODUCTS.TXT
      from server directory pub/other. The project makefiles are:

         GETPRO16.MAK : for VB 3.0.
         GETPRO32.MAK : for VB 4.0 and above.

      9.4 HELLO32

      The HELLO32 example program connects to a specified FTP server and
      verifies that it is responding to commands. HELLO32 requires Visual
      Basic version 5.0 or higher. The project file is:

         HELLO32.VBP : for VB 5.0 and above.








     FCE4VB Users Manual                                       Page 13

      10.0 Registration

      10.1 Professional Version

      The professional version of FCE4VB may be registered for $95 plus $8
      S&H ($14 outside of North America). Shipping and handling charges
      include the cost of the printed manuals.  The professional version
      DLL is also branded with your company name and may be distributed
      with your applications.

      10.2 Student Version

      We offer an "academic price" of 40% off the normal price for prepaid
      email orders to faculty and full time students currently enrolled in
      any accredited high school, college, or university. To qualify for
      the discount, your school must have a web site and you must have an
      email address at your school.

      When ordering, ask for the "academic discount", or enter "student
      at" (or "faculty at") and your schools web site address (URL) in the
      comments field of the order form on our web site order page . Your
      order will be sent to your email address at your school.

      Products bought with academic pricing can not be used for any
      commercial purpose.

      10.3 Updates

      When you order FCE4VB, you will receive a license file FCExxxx.LIC
      where xxxx is your customer number. Save this file!

      Updates are $20 by email if you attach your license file FCExxxx.LIC
      to the email, and $30 otherwise. There is an additional $8 charge
      ($14 outside of North America) if you want a disk and printed manuals
      mailed.























     FCE4VB Users Manual                                       Page 14

      11.0 Payment

      All prices are guaranteed for one year from the release date.
      Multiple copy discounts (3 or more) and site licenses are available.
      Please call for details.

      We accept American Express, VISA, MasterCard, Discover, checks in US
      dollars drawn on a US bank, International Postal Money Orders, and
      purchase orders (POs) within the USA from recognized US schools and
      companies listed in Dun & Bradstreet.

      For credit card orders, be sure to include the account number, the
      expiration date, the exact name on the card, and the complete card
      billing address (the address to which the credit card bill is
      mailed).

      Print the file INVOICE.TXT if a "Pro Forma" invoice is needed. The
      registered package includes:

         o  Win16 & Win32 FCE4VB Libraries w/o shareware screens.
         o  Printed Users Manual & Reference Manual.
         o  Telephone and email support for one year.

      FCE4VB is shipped on a 3.5" HD diskette.

      There are several ways to place your order:

      (1) Using our secure server at www.marshallsoft.com
      (2) Email INVOICE.TXT to [e-mail]
      (3) FAX INVOICE.TXT to 256-880-0925 (24 hours).
      (4) Call us at 256-881-4630 (7 AM to 7 PM CST Monday through Friday).
      (5) Mail INVOICE.TXT to

               MarshallSoft Computing, Inc.
               POB 4543
               Huntsville AL 35815
               USA





















     FCE4VB Users Manual                                       Page 15

      12.0 Legal Issues

      12.1 License

      MarshallSoft Computing, Inc. grants the registered user of FCE4VB the
      right to use one copy of the FCE4VB DLL's on a single computer in the
      development of any software product. The user may not use the library
      on more than one computer at the same time.

      The "student" ($57) registered DLL's may not be distributed under any
      circumstances, nor may they be used for any commercial purpose.

      The "professional" ($95) registered DLL's may be distributed (without
      royalty) in object form only, as part of the user's compiled
      application. The registered DLL's may NOT be distributed as part of
      any software development system (compiler or interpreter) without our
      express written permission.

      When you register, you will be sent a "key code" which enables access
      to the registered DLL's. You may NOT distribute or make known this
      key code. (see section 4.3 "Key Code").

      12.2 Warranty

      MARSHALLSOFT COMPUTING, INC.  DISCLAIMS ALL WARRANTIES RELATING TO
      THIS SOFTWARE, WHETHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT
      LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
      A PARTICULAR PURPOSE, AND ALL SUCH WARRANTIES ARE EXPRESSLY AND
      SPECIFICALLY DISCLAIMED. NEITHER MARSHALLSOFT COMPUTING, INC.  NOR
      ANYONE ELSE WHO HAS BEEN INVOLVED IN THE CREATION, PRODUCTION, OR
      DELIVERY OF THIS SOFTWARE SHALL BE LIABLE FOR ANY INDIRECT,
      CONSEQUENTIAL, OR INCIDENTAL DAMAGES ARISING OUT OF THE USE OR
      INABILITY TO USE SUCH SOFTWARE EVEN IF MARSHALLSOFT COMPUTING, INC.
      HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR CLAIMS. IN NO
      EVENT SHALL MARSHALLSOFT COMPUTING, INC.'S LIABILITY FOR ANY SUCH
      DAMAGES EVER EXCEED THE PRICE PAID FOR THE LICENSE TO USE THE
      SOFTWARE, REGARDLESS OF THE FORM OF THE CLAIM. THE PERSON USING THE
      SOFTWARE BEARS ALL RISK AS TO THE QUALITY AND PERFORMANCE OF THE
      SOFTWARE.

      Some states do not allow the exclusion of the limit of liability for
      consequential or incidental damages, so the above limitation may not
      apply to you.

      This agreement shall be governed by the laws of the State of Alabama
      and shall inure to the benefit of MarshallSoft Computing, Inc.  and
      any successors, administrators, heirs and assigns.  Any action or
      proceeding brought by either party against the other arising out of
      or related to this agreement shall be brought only in a STATE or
      FEDERAL COURT of competent jurisdiction located in Madison County,
      Alabama. The parties hereby consent to in personam jurisdiction of
      said courts.






     FCE4VB Users Manual                                       Page 16

      13.0 Summary


      12.1 Revision History


      Version 1.2: August 16, 1999

          o  The initial release of the VB version of FCE.

      12.2 FCE4VB Function Summary

      Refer to the FCE4VB Reference Manual (FCE4VB_R.TXT) for detailed
      information on the communications and support functions.  A one line
      summary of each function follows.

      There are 24 functions in the FCE library.

      +-------------------------------------------------------------------+
      |         fceAbort : Aborts download or upload in progess.          |
      |        fceAttach : Attaches FCE.                                  |
      |         fceClose : Closes connection opened by fceConnect.        |
      |       fceConnect : Connects to FTP server and logs on.            |
      |       fceDelFile : Deletes file on server.                        |
      |        fceDriver : Executes next FCE state.                       |
      |       fceExtract : Extracts strings.                              |
      |     fceErrorText : Formats error message.                         |
      |       fceGetFile : Downloads file.                                |
      |    fceGetInteger : Gets numeric parameter.                        |
      |   fceGetLocalDir : Gets local directory.                          |
      |  fceGetServerDir : Gets server directory.                         |
      |     fceGetString : Gets string parameter.                         |
      |       fceGetList : Lists files on server.                         |
      |         fceHello : Issues a "NOOP" to the FTP server.             |
      | fceMakeServerDir : Make server directory.                         |
      |       fcePutFile : Uploads file.                                  |
      |       fceRelease : Releases FCE.                                  |
      |  fceDelServerDir : Deletes server directory.                      |
      |    fceSetInteger : Set numeric parameter.                         |
      |   fceSetLocalDir : Sets local directory.                          |
      |       fceSetMode : Sets transfer mode (ASCII or BINARY).          |
      |  fceSetServerDir : Sets server directory.                         |
      |     fceSetString : Sets string parameter.                         |
      +-------------------------------------------------------------------+














     FCE4VB Users Manual                                       Page 17


      12.3 FCE Error Return Code List


      The complete list of FCE error codes follows.


      +-----------------------+-----------------------------------------+
      | FCE_NO_ERROR          | No error.                               |
      | FCE_CANNOT_COMPLY     | Cannot comply. Not always an error.     |
      +-----------------------+-----------------------------------------+
      | FCE_ABORTED           | Internal checksum fails!                |
      | FCE_ALREADY_ATTACHED  | Already attached.                       |
      | FCE_BAD_KEY_CODE      | Bad key code (2nd argumnet in fceAttach)|
      | FCE_BAD_STATUS_FLAG   | Bad status flag passed to fceStatus.    |
      | FCE_CANNOT_ALLOC      | Cannot allocate memory.                 |
      | FCE_CANNOT_COMPLY     | Cannot comply.                          |
      | FCE_CANNOT_CREATE_SOCK| Cannot create socket.                   |
      | FCE_CHAN_OUT_OF_RANGE | Channel out of range.                   |
      | FCE_CONNECT_ERROR     | Error attempting to connect.            |
      | FCE_EOF               | Socket has been closed.                 |
      | FCE_SERVER_ERROR      | FTP server returned error.              |
      | FCE_INVALID_SOCKET    | Invalid socket.                         |
      | FCE_IS_BLOCKING       | WINSOCK is currently blocking.          |
      | FCE_NO_HOST           | No host name.                           |
      | FCE_NO_SERVER         | Cannot find FTP server.                 |
      | FCE_NO_SOCK_ADDR      | No available sockaddr structures.       |
      | FCE_NOT_ATTACHED      | Must call fceAttach first.              |
      | FCE_NOT_SERVER        | Illegal chars in server name.           |
      | FCE_PASS_NULL_ARG     | PASSWORD not specified.                 |
      | FCE_SERVER_NULL_ARG   | SERVER not specified.                   |
      | FCE_TIMED_OUT         | Socket timed out.                       |
      | FCE_USER_NULL_ARG     | USER name not specified.                |
      | FCE_MODE_NOT_AB       | Must specify 'A' or 'B' for mode.       |
      | FCE_LISTEN_ERROR      | Listen error.                           |
      | FCE_LISTENER_SILENT   | No response of listener socket.         |
      | FCE_ACCEPT_SILENT     | Timed out waiting for accept.           |
      | FCE_SOCK_READ_ERROR   | Socket read error.                      |
      | FCE_NOT_COMPLETED     | Last GET or PUT not completed.          |
      +-----------------------+-----------------------------------------+

      NOTES:
      (1) All error codes are negative.
      (2) FCE_ABORTED will be returned if the DLL has been modified. You
          should never get this message!













     FCE4VB Users Manual                                       Page 18