ft_cancel - Asynchronen Auftrag abbrechen

ft_cancel() löscht asynchrone Aufträge, die gerade bearbeitet werden oder die noch auf die Bearbeitung warten.

Syntax

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

Parameter

session	Sitzungsnummer der Sitzung, in der der Auftrag abgebrochen werden soll.
rid	Request-Id des Auftrags, der abgebrochen werden soll. Wenn der abzubrechende Auftrag in einer anderen Sitzung erteilt wurde, muss der aktuellen Sitzung dasselbe Arbeitsverzeichnis zugeordnet sein wie der Sitzung, in der der Auftrag erteilt wurde. Außerdem muss das Programm, in dem der asynchrone Auftrag abgebrochen wird, unter derselben Kennung laufen wie das, in dem der Auftrag erteilt wurde.
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.