Description
-
Appends data from a fixed-size buffer to a remote file.
Return type
-
A Long value. If successful, 0 is returned, otherwise
error as specified here.
Syntax
-
long Sftp_AppendDataLen(void *Sftp, void *Data,
int DataLen, char *RemoteFile);
The AppendData function syntax has these parts:
| void
*Sftp |
Handle of created Sftp
instance. |
| void
*Data |
Represents data that
will be stored on the server. |
| int DataLen |
Length of the data buffer. |
| char
*RemoteFile |
Full path to file on
the server. |
Remarks
-
Unlike the AppendFile
method which appends the contents of a local file to the server, AppendDataLen
will append the contents of the Data buffer 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.
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.
|
