ft_open - Sitzung eröffnen

ft_open() eröffnet eine Sitzung. Nur innerhalb einer Sitzung können Sie Dateien asynchron übertragen (Funktion ft_transfer()) und asynchrone Dateiübertragungsaufträge verwalten (Funktionen ft_reqlist(), ft_reqstat(), ft_cancel() und ft_reqterm()).
ft_open() liefert als Resultat eine Sitzungsnummer, die die Sitzung eindeutig kennzeichnet. Diese Sitzungsnummer muss bei Funktionsaufrufen innerhalb derselben Sitzung als Parameter angegeben werden.
In einem Programm können Sie mehrere Sitzungen gleichzeitig eröffnen, wenn die zugeordneten Arbeitsverzeichnisse unterschiedlich sind.

Syntax

#include <ftapi.h>
void *ft_open(const char *workdir,          /* Eingabe */
              struct ft_err *errorinfo,
              void *options);               /* Eingabe */

Parameter

workdir

Name des Arbeitsverzeichnisses, das der Sitzung zugeordnet wird.
In diesem Arbeitsverzeichnis werden Dateien mit Verwaltungsinformationen abgelegt.
Beachten Sie, dass die Kennung, unter der die Programmschnittstelle aufgerufen wird, das Recht haben muss, Dateien in diesem Dateiverzeichnis anzulegen.

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

n	Sitzungs-Id (n != 0). Dieser Wert muss bei Funktionsaufrufen innerhalb derselben Sitzung angegeben werden.
NULL	Fehler. Die Fehlerart wird in errorinfo hinterlegt.