Xceed FTP Library Documentation
SendMemoryFileEx method
XceedFtp control reference > Methods > SendMemoryFileEx method

Description

This method allows you to begin the process of sending data from memory directly into a file on the FTP server in the same way as the SendMemoryFile method, but does not require setting the BackgroundProcessing property.

The SendMemoryFileEx method always returns right away, letting the user call SendMemoryFileData at will to provide the actual memory data that the library will send into the file.

When using this method, the library cannot inform you if the remote file already exists, but if it does exist, the bAppend parameter allows you to decide if the file should be overwritten or appended to.

When possible, set the lSize parameter to inform the library about how much memory you will be sending. This will allow the FileTransferStatus event to provide statistics on the transfer operation. Set lSize to 0 if you don't know how much data you will be sending.

This method can only be used when the CurrentState property's value is fcsConnected.

Parameters 

Parameter Description
sRemoteFilename  The file on the FTP server to put the memory data into. Specifying a path is optional. The path can be relative to the FTP server's current working folder, or can be an absolute path on the remote system.
bAppend  Set to True if you want to append to the file if it already exists. Set to False if you want to overwrite the file if it already exists.
lSize  The total size, if known, of the memory data you will be providing to the library to write into the remote file. If the size is unknown, set this to 0.

 

Declaration  

HRESULT SendMemoryFileEx( [in] BSTR sRemoteFilename, [in] VARIANT_BOOL bAppend, [in] long lSize )

Applicable properties

AccountName, AllocateStorage, LocalDataAddress, LocalDataPort, PassiveMode, RemoteDataAddress, RemoteDataPort

Events triggered

FileTransferStatus, LoggingCommandLine, ProcessCompleted, SendingFile