ft_reqstat - Status eines Auftrags ermitteln

ft_reqstat() ermittelt den Status eines asynchronen Dateiübertragungsauftrags.

Syntax

#include <ftapi.h>
int ft_reqstat(const void *session,          /* Eingabe */
               long rid,                     /* Eingabe */
               struct ft_status *stat,
               struct ft_err *errorinfo,
               void *options);               /* Eingabe */

Parameter

session	Sitzungs-Id der Sitzung, in der der Status des Übertragungsauftrags ermittelt werden soll.
rid	Request-Id des Auftrags, dessen Status ermittelt werden soll. Wenn der Auftrag in einer anderen Sitzung erteilt wurde, muss der aktuellen Sitzung dasselbe Arbeitsverzeichnis zugeordnet sein wie der Sitzung, in der der Auftrag erteilt wurde.
stat	Bereich, in den die Statusinformation geschrieben wird. Dazu dient die Struktur ft_status: #define STAT_FUD_LEN 65 #define STAT_FN_LEN 128 struct ft_status { int ftstatvers; /* Eingabe */ enum ft_stat status; /* Ausgabe */ char fn[STAT_FN_LEN]; /* Ausgabe */ long tid; /* Ausgabe */ int msg; /* Ausgabe */ char fud[STAT_FUD_LEN]; /* Ausgabe */ }; ftstatvers Version der Datenstruktur. ftstatvers muss mit dem Wert FT_STATV1 oder FT_STATV2 versorgt werden. status Status des Auftrags: FT_STATW Der Auftrag wartet auf Ausführung. FT_STATR Der Auftrag wird ausgeführt.   FT_STATA Der Auftrag wurde abgebrochen. FT_STATT Der Auftrag ist beendet. fn Lokaler mit ’\0’ terminierter Dateiname. Wenn der Dateiname länger als 127 Zeichen ist, wird er gekürzt. tid Transfer-Id msg Meldungsnummer bei abgebrochenen oder beendeten Aufträgen (siehe Online-Hilfe). Mit Hilfe des Feldes ft_apivers in der Struktur ft_options kann das zu verwendende Meldungsnummern-Schema festgelegt werden. fud Mit '\0' terminierte "Further Details", die im Fehlerfall eine genauere Fehlerursache angeben können. Der Parameter fud steht nur dann zur Verfügung, wenn ftstatvers auf den Wert FT_STATV2 gesetzt wird und beim Aufruf von ft_reqstat der Parameter options angegeben ist.
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.
options	Die Angabe des Parameters options ist optional. Wird der Wert NULL angegeben, dann ist das Meldungsverhalten der Programmschnittstelle kompatibel zur Programmschnittstelle von openFT < V10. Alternativ können durch die Angabe der Struktur ft_options (siehe Abschnitt „ft_options“ (Version der Programmschnittstelle)) das openFT-Meldungsnummernschema ab openFT V10 und die Funktionserweiterungen aktiviert werden.

Rückgabewert

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