fts_ftp_event_ex() - obtain the transmission-end results
- Organization of this page
Format
#include <apihead.h> int fts_ftp_event_ex( int sock, FTS_FTP_API_RETDATA_EX *retdata )
Function
This function obtains the termination results of a transmission that was registered by fts_ftp_asyn_request_ex().
You can determine whether the transmission was successful by checking the trans_status member of the transmission-end information structure.
Arguments
sock
Specifies the return value of fts_ftp_open_ex().
retdata
Specifies the address of a transmission-end information structure. It returns the termination result of transmission.
Notes
-
Call this function after you have called fts_ftp_open_ex().
-
If transmission is not finished when this function is issued, the function waits until the transmission is finished.
Return values
TRUE |
Normal |
FALSE |
Abnormal. Acquisition of the transmission-end information failed. |
A value indicating an error is set in fts_errno. The table below lists and describes the return values for error information. In the case of an error other than one listed below, the system function's error number is set. For details, see the displayed error number for the system function.
Return value of extended error information (decimal) |
Description |
Can be retried? |
---|---|---|
FTS_API_ERROR_DISCONNECT (805306116) |
A connection with the JP1/FTP daemon was released. To register the transmission request again, you must issue fts_ftp_close() and start the process over from fts_ftp_open_ex(). |
No |
FTS_API_ERROR_NODATA (805306120) |
There is no registered transmission request. |
No |
FTS_API_ERROR_NOTSOCK (805306124) |
The return value of fts_ftp_open_ex() might not have been set in the first argument. |
No |
FTS_API_ERROR_LOGIC (805306128) |
A logical conflict error occurred in API. |
No |