tfFtpAppe

Table of Contents >> Application Reference >> FTP Client API

#include <trsocket.h>

int tfFtpAppe	(
	ttUserFtpHandle ftpUserHandleA,
	ttUserFtpHandle ftpUserHandleB,
	char * fromFileNamePtr,
	char * toFileNamePtr
	);

Function Description

This function is used to append data to a file on remote FTP server (corresponding to ftpUserHandleA). This function is implemented for both passive mode and normal mode, and also works with both one FTP server model and two FTP servers model.

• One server model:

If the ftpUserHandleB parameter is NULL, then the one-server model is used, and the operation could be either in server active mode or server passive mode. By default the server is in active mode. The user needs to call tfFtpTurnPasv() with the TM_FTP_PASSIVE_MODE_ON flag to turn the server in passive mode.

• Two server model:

If the ftpUserHandleB parameter is non null, then the two-server model is used, and the first session should be in passive mode, and the second session should be in active mode. The user needs to call tfFtpTurnPasv(), passing the ftpUserHandleA parameter, and the TM_FTP_PASSIVE_MODE_ON flag.

Parameters

• ftpUserHandleA

  The user handle of the main FTP session that will be operated on.

• ftpUserHandleB

  The user handle of the second FTP session for use with the two server model.

• fromFileNamePtr

  A pointer to the source file name string.

• toFileNamePtr

  A pointer to the destination file name string.

Returns

• TM_ENOERROR

  Success.

• TM_EWOULDBLOCK

  The call is non-blocking and did not complete.

• TM_EINVAL

  Invalid ftpUserHandleA, ftpUserHandleB, fromFileNamePtr, or toFileNamePtr.

• TM_EACCES

  Previous command has not finished.

• TM_ENOTLOGIN

  Command requires user to be logged in, and user is not.

• TM_ENOTCONN

  Command requires connection, and user is not connected.

• TM_EOPNOTSUPP

  Command not supported by the user.

• TM_FTP_NAVAIL

  Requested action not taken: file unavailable.

• TM_FTP_NOCMD

  Command not implemented.

• TM_FTP_XFERSTART

  Data connection already open; transfer started.

• TM_FTP_FILEOKAY

  File status okay; about to open data connection.

• TM_FTP_DATAOPEN

  Can't open data connection.

• TM_FTP_XFERABOR

  Connection trouble, closed; transfer aborted.

• TM_FTP_LOCALERR

  Requested action aborted: local error in processing.

• TM_FTP_EXSPACE

  Requested file action aborted: exceed storage allocation.

• TM_FTP_NOSPACE

  Request action not taken: insufficient storage space in system.

• TM_FTP_FILENAVAIL

  Requested file action not taken: file unavailable.

• TM_FTP_FILENAME

  Requested action not taken: file name not allowed.

• TM_FTP_SYNTAXCMD

  Syntax error, command unrecognized

• TM_FTP_SYNTAXARG

  Syntax error in parameters or arguments

• TM_FTP_NOCMDPARAM

  Command not implemented for that parameter.

• TM_FTP_SERVNAVAIL

  Service not available, closing FTP connection.

• TM_FTP_NOTLOGIN

  Not logged in.

Table of Contents >> Application Reference >> FTP Client API