COM Objects > RecordedSound object > Methods > RecordedSound.RequestUploadToFTP method

Remarks

Requests to start an uploading session of the recorded sound to a FTP server.

In case you should need to upload a file stored inside the local hard disk you could use the RequestUploadFileToFTP method.

An uploading session can be terminated before completion through a call to the RecordedSound.CancelUploadToFTP method.

A successful call to this method will fire the SoundUploadStarted event. Once the upload has been performed completely, the control will fire the SoundUploadDone event. During the uploading session the container application is notified about the advancement percentage through the SoundUploadPerc method.

For further details about recorded sound methods refer to the RecordedSound object section.

For further details see the How to perform a recording session section.

An example of use of this method can be found inside the UploadSoundToFTP sample.

Syntax

[Visual Basic]

control.RecordedSound.RequestUploadToFTP (

strHost as String,

strUsername as String,

strPassword as String,

nPort as Long,

bPassiveMode as enumBoolean,

strDirectory as String,

strFilename as String

) as enumErrorCodes

[C++]

short control.RecordedSound.RequestUploadToFTP (

LPCTSTR strHost,

LPCTSTR strUsername,

LPCTSTR strPassword,

long nPort,

short bPassiveMode,

LPCTSTR strDirectory,

LPCTSTR strFilename

);

Parameter

Description

strHost

String representing the FTP host address

strUsername

String representing the FTP account username

strPassword

String representing the FTP account password

nPort

FTP port number

bPassiveMode

Boolean value for FTP "passive mode" flag.

Supported values are the following:

Mnemonic Value	Value	Meaning
BOOL_FALSE	0	Don't use passive mode
BOOL_TRUE	1	Use passive mode

strDirectory

String representing the destination directory on FTP server

strFilename

String representing the destination filename

Return value

Value	Meaning

Negative value	An error occurred, check the LastError property value in order to see the error code meaning
enumErrorCodes.ERR_NOERROR (0)	The method call was successful.