TElSimpleFTPSClient.OnFileOperationResult event

TElSimpleFTPSClient.OnFileOperationResult

This event reports the result of particular file operation within a multi-file operation.

Declaration

[C#]
event TElFTPFileOperationResultEvent OnFileOperationResult;
delegate void TElFTPFileOperationResultEvent(Object Sender, TSBFtpFileOperation Operation, string RemotePath, string LocalPath, int ErrorCode, string Comment, ref bool Cancel);

[VB.NET]
Event OnFileOperationResult As TElFTPFileOperationResultEvent
Delegate Sub TElFTPFileOperationResultEvent(ByVal Sender As Object, ByVal Operation As TSBFtpFileOperation, ByVal RemotePath As String, ByVal LocalPath As String, ByVal ErrorCode As Integer, ByVal Comment As String, ByRef Cancel As Boolean)

[Pascal]
property OnFileOperationResult : TElFTPFileOperationResultEvent
TElFTPFileOperationResultEvent = procedure(Sender : TObject; Operation As TSBFtpFileOperation, const RemotePath, LocalPath : string; ErrorCode : integer; const Comment : string; var Cancel : boolean) of object;

[C++]
    void get_OnFileOperationResult(TElFTPFileOperationResultEvent &pMethodOutResult, void * &pDataOutResult);
    void set_OnFileOperationResult(TElFTPFileOperationResultEvent pMethodValue, void * pDataValue);
    typedef void (SB_CALLBACK *TElFTPFileOperationResultEvent)(void * _ObjectData, TObjectHandle Sender, TSBFtpFileOperationRaw Operation, const char * pcRemotePath, int32_t szRemotePath, const char * pcLocalPath, int32_t szLocalPath, int32_t ErrorCode, const char * pcComment, int32_t szComment, int8_t &Cancel);

[PHP]
    TElFTPFileOperationResultEvent|callable|NULL get_OnFileOperationResult()
    void set_OnFileOperationResult(TElFTPFileOperationResultEvent|callable|NULL $Value)
    callable TElFTPFileOperationResultEvent(TObject $Sender, integer $Operation, string $RemotePath, string $LocalPath, integer $ErrorCode, string $Comment, bool &$Cancel)

[Java]
    TElFTPFileOperationResultEvent getOnFileOperationResult();
    void setOnFileOperationResult(TElFTPFileOperationResultEvent Value);
    TElFTPFileOperationResultEvent.Callback OnFileOperationResult = new TElFTPFileOperationResultEvent.Callback() {
        public void TElFTPFileOperationResultEventCallback(TObject Sender, TSBFtpFileOperation Operation, String RemotePath, String LocalPath, int ErrorCode, String Comment, TSBBoolean Cancel) {
            //...
        }
    }

Parameters

Operation - the operation to be performed on the file.
RemotePath - specifies the name and path to the remote file.
LocalPath - specifies the name and path to the local file.
ErrorCode - operation error code.
Comment - error comment.
Cancel - allows to cancel the operation.
pcRemotePath - specifies the name and path to the remote file.
szRemotePath - the length of pcRemotePath.
pcLocalPath - specifies the name and path to the local file.
szLocalPath - the length of pcLocalPath.
pcComment - error comment.
szComment - the length of pcComment.

Values

[.NET] [C++]	[Pascal]	Description
ffoDownloadFile = 0	ffoDownloadFile	Download file
ffoUploadFile = 1	ffoUploadFile	Upload file
ffoDeleteFile = 2	ffoDeleteFile	Delete file

Definition	Value	Possible reason and steps to take
ERROR_SSL_CONNECTION_CANCELLED_BY_USER	73729 (0x12001)
ERROR_SSL_TIMEOUT	73730 (0x12002)
ERROR_SSL_UNSUPPORTED_MAC_ALGORITHM	73731 (0x12003)
ERROR_SSL_UNEXPECTED_MESSAGE	75777 (0x12801)	Connection is made to/from a service that doesn’t talk proper SSL (e.g. a plain HTTP connection is made to an HTTPS port). Re-check that both client and server services are talking SSL. Unsupported version of the protocol. Try to play with Versions property of the SSL component and check if any of the combination helps.
ERROR_SSL_BAD_RECORD_MAC	75778 (0x12802)	The peers failed to negotiate a shared key material. Try connecting with different cipher suites one-by-one and check if any of them helps. If neither does, try to use a different protocol version.
ERROR_SSL_DECRYPTION_FAILED	75779 (0x12803)
ERROR_SSL_DECODE_ERROR	75792 (0x12810)
ERROR_SSL_DECRYPT_ERROR	75793 (0x12811)
ERROR_SSL_RECORD_OVERFLOW	75780 (0x12804)	Packet size too large. Try to decrease the maximal size of the packet by adjusting the MaxFragmentLength extension.
ERROR_SSL_DECOMPRESSION_FAILURE	75781 (0x12805)	Compression or decompression failure. Switch off compression (CompressionAlgorithms property).
ERROR_SSL_HANDSHAKE_FAILURE	75782 (0x12806)	Incompatible versions or cipher suite lists. Try to play with version and cipher suite sets. Check that the server certificate is provided and has an associated private key.
ERROR_SSL_ILLEGAL_PARAMETER	75789 (0x1280D)
ERROR_SSL_NO_CERTIFICATE	75783 (0x12807)	The certificate provided by the peer is not valid.
ERROR_SSL_BAD_CERTIFICATE	75784 (0x12808)
ERROR_SSL_UNSUPPORTED_CERTIFICATE	75785 (0x12809)
ERROR_SSL_CERTIFICATE_REVOKED	75786 (0x1280A)
ERROR_SSL_CERTIFICATE_EXPIRED	75787 (0x1280B)
ERROR_SSL_CERTIFICATE_UNKNOWN	75788 (0x1280C)
ERROR_SSL_UNKNOWN_CA	75790 (0x1280E)
ERROR_SSL_ACCESS_DENIED	75791 (0x1280F)	The requested application-layer resource cannot be accessed by the requestor. Check with the administrator of the remote resource.
ERROR_SSL_EXPORT_RESTRICTION	75794 (0x12812)	The peer is only configured to use exportable cipher suites. Switch on support for "EXPORT" cipher suites.
ERROR_SSL_PROTOCOL_VERSION	75795 (0x12813)	The peers have not been able to negotiate a version to use (no shared protocol versions).
ERROR_SSL_INSUFFICIENT_SECURITY	75796 (0x12814)	The cipher suites mutually supported by the peers are too weak and do not provide an adequate level of security.
ERROR_SSL_INTERNAL_ERROR	75797 (0x12815)	Contact the vendor.
ERROR_SSL_USER_CANCELED	75798 (0x12816)	Application layer has shut down the connection.
ERROR_SSL_NO_RENEGOTIATION	75799 (0x12817)	One of the peers requested a renegotiation, which was refused by the other. Note that you will get this error (as a warning) if you return Allow = false from the OnRenegotiationStart event handler.
ERROR_SSL_CLOSE_NOTIFY	75800 (0x12818)	Does not indicate an error condition. The SSL connection was closed gracefully and can be restored or cloned in future.
ERROR_SSL_UNKNOWN_PROTOCOL_ERROR	75801 (0x12819)
Internal errors. These errors should not occur in normal circumstances. Customers are expected to contact support team for further investigation of any of the below issues.
ERROR_SSL_CLIENT_KEX_COMPUTATION_ERROR	73732 (0x12004)	Failed to calculate key exchange record. Please contact the support team.
ERROR_SSL_COMPRESSION_ERROR	73733 (0x12005)	Unidentified compression error. Please contact the support team.
ERROR_SSL_CRYPTO_NOT_INITIALIZED	73734 (0x12006)	Encryption subsystem not initialized. Please contact the support team.
ERROR_SSL_PRIVATE_KEY_OPERATION_FAILED	73735 (0x12007)	Private key operation failed. Please ensure that the private key of the certificate used for authentication is accessible (e.g. that the hardware token is in). If the key is fine, please contact the support team.

Description

This event is fired by TElSimpleFTPSClient when file operation on particular file in a multi-file operation DownloadFiles or UploadFiles is finished.

Discuss this help topic in SecureBlackbox Forum