ft_properties - Eigenschaften der Programmschnittstelle ermitteln

ft_properties() ermittelt die Version der Programmschnittstelle von openFT und versionsspezifische Systemwerte. Mit diesen von der Funktion ft_properties() gelieferten Werten überprüfen Sie, ob Ihr Programm mit der gleichen oder einer anderen Version der Programmschnittstelle erstellt wurde.

Syntax

#include <ftapi.h>
int ft_properties(struct ft_prop *prop,
                  struct ft_err *errorinfo);

Parameter

prop

Bereich, in dem die Version der verwendeten openFT-Programmschnittstelle sowie die gültigen Systemwerte hinterlegt sind. Dazu dient die Struktur ft_prop: struct ft_prop { int ftpropvers; /* Eingabe */ int ftvers; /* Ausgabe */ long optfunct; /* Ausgabe */ int maxlfnsize; /* Ausgabe */ int maxrfnsize; /* Ausgabe */ int maxsyssize; /* Ausgabe */ int maxadmissize; /* Ausgabe */ int maxaccsize; /* Ausgabe */ int maxpwdsize; /* Ausgabe */ int maxfpwdsize; /* Ausgabe */ int maxrecord; /* Ausgabe */ int maxacntsize; /* Ausgabe */ int maxlegalqsize; /* Ausgabe */ int maxcpwdsize; /* Ausgabe */ int maxlprocsize; /* Ausgabe */ int maxrprocsize; /* Ausgabe */ int maxcmdlen; /* Ausgabe */ }; Die Felder der Struktur ft_prop haben folgende Bedeutung: ftpropvers Version der Datenstruktur. ftpropvers muss mit dem Wert FT_PROPV1 oder FT_PROPV2 versorgt werden. ftvers Version von openFT, z.B. 1000 für Version 10.0 oder 1210 für Version 12.1. optfunct (Für späteren Gebrauch reserviert.) maxlfnsize Maximale Länge für den lokalen Dateinamen. maxrfnsize Maximale Länge für den Dateinamen im fernen System. maxsyssize Maximale Länge für den Namen des fernen Systems. maxadmissize Maximale Länge für die Benutzerkennung bzw. die Zugangsberechtigung im fernen System. maxaccsize Maximale Länge für die Abrechnungsnummer im fernen System. maxpwdsize Maximale Länge für das Kennwort im fernen System. maxfpwdsize Maximale Länge für das Dateikennwort im fernen System. maxrecord Maximale Satzlänge. maxacntsize Maximale Länge für das Abrechnungskonto beim FTAM-Partner. maxlegalqsize Maximale Länge der rechtlichen Bestimmung (Copyright). maxcpwdsize Maximale Länge für das Kennwort zum Erzeugen einer Datei im fernen System. maxlprocsize Maximale Gesamtlänge der lokalen Folgeverarbeitungen. maxrprocsize Maximale Gesamtlänge der fernen Folgeverarbeitungen. maxcmdlen Maximale Länge des im fernen System mit ft_xcopen() auszuführenden Kommandos. Der Parameter maxcmdlen steht nur dann zur Verfügung, wenn ftpropvers auf den Wert FT_PROPV2 gesetzt wird.

errorinfo

Bereich, in dem genauere Informationen hinterlegt sind, wenn ein Fehler aufgetreten ist (siehe Abschnitt „ft_err" (Fehlerbehandlung)). Die Angabe des Parameters ist optional. Wenn Sie keine genaueren Fehlerinformationen benötigen, können Sie für errorinfo den Wert NULL angeben.

Rückgabewert

0	Kein Fehler.
-1	Fehler. Die Fehlerart wird in errorinfo hinterlegt.