You can use ft_reqterm() to terminate an asynchronous file transfer request. This is possible only if the request has the status "aborted" or "completed" . ft_reqterm() deletes the associated file containing the management information. Then the request ID is deleted and can no longer be addressed.
Syntax
#include <ftapi.h>
int ft_reqterm(const void *session, /* input */
long rid, /* input */
struct ft_err *errorinfo,
void *options); /* input */
Parameter
session
Session ID of the session in which the transfer request is to be terminated.
rid
ID of the request to be terminated.
If the request was issued in a different session, the current session must be assigned the same working directory as the one in which the request was issued.
errorinfo
Area in which detailed information is stored if an error is encountered (see section “ft_err” (Error handling)).
The specification of this parameter is optional. If you do not require any more precise error information then you can specify the value NULL for errorinfo.
options
The specification of the options parameter is optional. If the value NULL is specified then message activity at the program interface is compatible with that of the program interface of openFT < V10.
Alternatively, it is possible to specify the ft_options structure (see section “ft_options” (Version of the program interface)) to activate the openFT message number scheme as of openFT V10 and the extensions to the function.
Return value
0 | No error. |
-1 | Error. The error type is stored in errorinfo. |