You can use the function call ft_properties() to determine the version of the openFT program interface, as well as important version-specific system values. With this function, you ensure the executability of future versions of openFT - even without recompilation. This function call is above all important when you use programs that are to run with different versions of the program interface.
ft_options
The ft_credir() function introduced in version 2 of the openFT program interface and the extended file structures can only be used if the options parameter is specified for the corresponding functions.
The functions ft_sdopen() and ft_xcopen() introduced in version 3 of the openFT program interface can only be used if the options parameter is specified in the associated functions.
The ft_options structure is constructed as follows:
struct ft_options { int ftoptsvers; /* input */ int ftapivers; /* input */ };
The fields in the structure have the following meaning:
ftoptsvers
Version of the data structure.
The value FT_OPTSV1
must be entered for ftoptsvers.
ftapivers
Specifies the version of the program interface: FT_APIV2
The openFT message number (ft_err.detail=FTED_FTMSG
) specified in the additional parameter adheres to the new message number schema which was introduced in openFT V10.
FT_APIV3
This is required in order to use the functions ft_sdopen() and ft_xcopen(). The openFT message number (ft_err.detail =FTED_FTMSG)
specified in the additional parameter has the new message number scheme that was introduced in openFT V10.