Back to product page

PutFileAt function


Sends a file to the server, appending it at a given position.

Type

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

Syntax

  • C
long Sftp_PutFileAt(void *Sftp, char *LocalFile, char *RemotePath, __int64 RemotePos);
The PutFileAt(void *Sftp,char *LocalFile,char *RemotePath,__int64 RemotePos) syntax has these parts:
void *SftpHandle of the created Sftp instance.
char *LocalFileFull path to a file on local computer.
char *RemotePathFull path to a file/directory on the server.
__int64 RemotePos The file position at which data is stored in the remote file .

Remarks

The PutFileAt function will copy files from the local computer to the remote server, starting at the given position. During the transfer, the Progress callback will be called several times, depending on your network speed and length of the file. When copying is complete, the Done callback will be called.

If an error occurs during the transfer, the Done callback containing the ErrorCode and a description of the error will be called immediately and the transfer will be aborted. If you want to continue the transfer at a later time, or you want to resend the file, initiate the PutFileAt function again (immediately or after reconnecting, depending on the error that occurred). You can NOT use the Resume property to restart the transfer. Increase the value of the RemotePos argument instead!

This function can be initiated only when the State property is set to Connected. You cannot send a file if wodSFTP is busy doing something else.