ft_credir() creates a directory in the remote system.
Directory names must not exceed the length specified in the maxrfnsize field of the ft_prop structure, see section “ft_properties - Determine properties of the program interface”.
Syntax
#include <ftapi.h>
int ft_credir(const struct ft_admission *admis, /* input */
const struct ft_crepar *par, /* input */
struct ft_err *errorinfo,
void *options); /* input */
Parameters
admis
Specifications for the remote system (see section “ft_admission” (Specifications concerning the remote system)).
par
Specifications for the request which you declare with the structure ft_crepar:
struct ft_crepar
{
int creparvers; /* input */
char *dn; /* input */
char *mgmtpasswd; /* input */
char *fud; /* input */
int fudlen; /* input */
enum ft_fncmode fncmode; /* input */
};
The fields of the ft_crepar structure have the following meanings:
creparvers
Version of the data structure.
creparvers must be supplied the value FT_CPARV1 or FT_SPARV2
dn
Name of the directory that is to be created in the remote system.
Absolute and relative path specifications are permitted. Relative path specifications refer to the user ID defined in the admission profile if the FTAC function is used, otherwise to the HOME directory.
mgmtpasswd
Password for the directory if it is password-protected.
fud
Address of a data area for the so-called "Further Details" which can indicate a more detailed cause of error if errors occur.
If NULL is specified then no more detailed error cause is output. The fud parameter is only available if creparvers is set to the value FT_CPARV1 and the options parameter is specified when ft_credir is called.
fudlen
Length of the data area for fud.
The fudlen parameter is only available if creparvers is set to the value FT_CPARV1 and the options parameter is specified when ft_credir is called.
fncmode
Specifies the file-name encoding-mode.
FT_FNCTRANS
Specification of the remote file name and follow-up processing for the remote system in transparent mode (compatible to the previous version; default value after initialization with binary 0).
FT_FNCCHAR
Specification of the remote file name and follow-up processing for the remote system in character mode. They are interpreted according to the character code of the remote system, i.e. for UNIX partners according to the openFT operating parameter option (ftmodo –fnccs) that has been set there. –fnc=c is only permitted for openFT partners as of openFT V12.1B. This functionality is only available if creparvers is set to the value FT_CPARV2 and the Options parameter is specified when ft_transfer is called.
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 mandatory. The construction of the ft_options structure is described in section “Version of the program interface”.
Return value
0 | No error. The directory was created. |
-1 | Error. The directory was not created. |