ft_sdopen - Ermitteln der Attribute aller Dateien eines Dateiverzeichnisses starten

ft_sdopen() startet die Ermittlung der Attribute aller Dateien eines Dateiverzeichnisses im fernen System.
Dateiverzeichnisnamen dürfen die in der Struktur ft_prop im Feld maxrfnsize angegebene Länge nicht überschreiten (siehe Abschnitt „ft_properties - Eigenschaften der Programmschnittstelle ermitteln").

Syntax

#include <ftapi.h>
void *ft_sdopen(const struct ft_admission *admis,       /* Eingabe */
                struct ft_shwpar *par, 
                struct ft_err *errorinfo
                void *options);                        /* Eingabe */

Parameter

admis

Angaben für das ferne System (siehe Abschnitt „ft_admission" (Angaben zum fernen System)).

par

Angaben für den Auftrag, die Sie mit der Struktur ft_shwpar bekanntgeben:

struct ft_shwpar
{
   int  shwparvers;      /* Eingabe */
   char *fn;             /* Eingabe */
   char *mgmtpasswd;     /* Eingabe */
   char *fud;            /* Eingabe */
   int  fudlen;          /* Eingabe */
};

Die Felder der Struktur ft_shwpar haben folgende Bedeutung:

shwparvers

Version der Datenstruktur.
shwparvers muss mit dem Wert FT_SPARV1 oder FT_SPARV2 versorgt werden.

fn

Name des Dateiverzeichnisses, für dessen Dateien die Attribute ermittelt werden sollen.
Absolute und relative Pfadangaben sind erlaubt. Relative Pfadangaben beziehen sich auf die im Berechtigungsprofil festgelegte Benutzerkennung, wenn die FTAC-Funktion eingesetzt wird, sonst auf das HOME-Verzeichnis, siehe "Dateiübertragung".

mgmtpasswd

Kennwort des Dateiverzeichnisses, falls es mit einem Kennwort geschützt ist.

 

fud

Adresse eines Datenbereichs für die sogenannten "Further Details", die im Fehlerfall eine genauere Fehlerursache angeben können.
Bei Angabe von NULL wird keine weiterführende Fehlerursache ausgegeben. Der Parameter fud steht nur dann zur Verfügung, wenn shwparvers auf den Wert FT_SPARV2 gesetzt wird und beim Aufruf von ft_showdir der Parameter options angegeben ist.

fudlen

Länge des Datenbereichs von fud.
Der Parameter fudlen steht nur dann zur Verfügung, wenn shwparvers auf den Wert FT_SPARV2 gesetzt wird und beim Aufruf von ft_showdir 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 obligatorisch. Der Aufbau der Struktur ft_options ist im Abschnitt „Version der Programmschnittstelle" beschrieben.

Rückgabewert

id	Id des Aufrufs. Diese muss bei ft_sdinfo() und ft_sdclose() angegeben werden.
NULL	Fehler. Die Fehlerart wird in errorinfo hinterlegt. Der Aufruf von ft_sdclose() ist im Fehlerfall nicht notwendig.