ft_close() beendet eine Sitzung, die mit ft_open() eröffnet wurde. Diese Funktion muss innerhalb einer Sitzung als letztes aufgerufen werden. ft_close() gibt nicht mehr benötigte Ressourcen frei. Die Sitzungsnummer wird gelöscht, anschließend können Sie sich nicht mehr auf diese Sitzung beziehen.
Syntax
#include <ftapi.h>
int ft_close(const void *session, /* Eingabe */
struct ft_err *errorinfo,
void *options); /* Eingabe */
Parameter
session
Sitzungsnummer der Sitzung, die beendet werden soll.
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. |