Back to product page

AppendData function


Appends data from a string variable to a remote file.

Type

A Long value. If successful, 0 is returned, otherwise error as specified here

Syntax

  • C
long Sftp_AppendData(void *Sftp, char *Data, char *RemoteFile);
The AppendData(void *Sftp,char *Data,char *RemoteFile) syntax has these parts:
void *SftpHandle of the created Sftp instance.
char *DataNull-terminated data that will be stored on the server.
char *RemoteFileFull path to a file on the server.

Remarks

Unlike the AppendFile method which appends the contents of a local file to the server, AppendData will append the contents of the Data variable to the specified file on the server. This is a very handy feature for small files that are stored in local variables within your programs. Although there is no size limit on sending data to the server in this way, you should try to limit data to 64kb - this will depend upon on how much data your programming environment able to store in a String variable.

What will AppendData do for you? It will copy the contents of the specified variable to a temporary file on disk (in the temporary folder) and then append that file to the server. Keep in mind that for this method to work you *MUST* allow the component to write to your disk. If you are using wodSFTP in an environment such as ASP, make sure the Guest user has privileges to create temporary files.

Once this temporary file is sent to the server, it will be deleted from the local disk.

Platforms

Windows