Mit dem Funktionsaufruf ft_properties() ermitteln Sie die Version der openFT-Programmschnittstelle sowie wichtige versionsspezifische Systemwerte. Mit dieser Funktion sichern Sie - auch ohne erneutes Compilieren - die Ablauffähigkeit Ihrer Programme mit zukünftigen Versionen von openFT. Dieser Funktionsaufruf hat vor allem Bedeutung, wenn Sie Programme einsetzen, die mit verschiedenen Versionen der Programmschnittstelle ablaufen sollen.
ft_options
Die in der Version 2 der openFT-Programmschnittstelle eingeführte Funktion ft_credir() und die erweiterten Datenstrukturen können nur verwendet werden, wenn der Parameter options bei den jeweilien Funktionen angegeben wird.
Die in Version 3 der openFT-Programmschnittstelle eingeführten Funktionen ft_sdopen() und ft_xcopen() können nur verwendet werden, wenn der Parameter options bei den jeweiligen Funktionen angegeben wird.
Die Struktur ft_options ist folgendermaßen aufgebaut:
struct ft_options
{
int ftoptsvers; /* Eingabe */
int ftapivers; /* Eingabe */
};
Die Felder der Struktur haben folgende Bedeutung:
ftoptsvers
Version der Datenstruktur.
ftoptsvers muss mit dem Wert FT_OPTSV1 versorgt werden.
ftapivers
gibt die Version der Programmschnittstelle an: FT_APIV2
Die im Parameter additional angegebene openFT-Meldungsnummer (ft_err.detail=FTED_FTMSG) folgt dem neuen Meldungsnummern-Schema, das in openFT V10 eingeführt wurde.
FT_APIV3
Wird für die Nutzung der Funktionen ft_sdopen() und ft_xcopen() benötigt. Die im Parameter additional angegebene openFT-Meldungsnummer (ft_err.detail =FTED_FTMSG) folgt dem neuen Meldungsnummern-Schema, das in openFT V10 eingeführt wurde.