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 */
};
The fields of the ft_crepar structure have the following meanings:
creparvers
Version of the data structure.
The value FT_CPARV1 must be entered for creparvers.
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.
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. |