ftpdir()

The ftpdir() call gets a directory in wide format from a host.

Syntax

#include <ftpapi.h>

int ftpdir(host, userid, passwd, acct, local, pattern,)
char *host;
char *userid;
char *passwd;
char *acct;
char *local;
char *pattern;

Parameters

host

Host running the FTP server.

To specify the port number (other than the well-know port) used by the FTP server, code the host name, followed by a blank, then the port number. For example, specify ftpdir ("server1 1234",...)

ID used for logon.

Password of the user ID.

Account (when needed); can be NULL.

Local file name.

The file name or pattern of the files to be listed on the foreign host. Patterns are any combination of ASCII characters. The following two characters have special meaning:
• Shows that any character or group of characters can occupy that position in the pattern.

• Shows that any single character can occupy that position in the pattern.

Return Values

The value 0 indicates success; the value -1 indicates an error. The value of ftperrno indicates the specific error. See Return Values for a description of the return codes.

Examples

int rc;rc=ftpdir("conypc","jason","ehgr1",NULL,"conypc.dir","*.c");

ftpdir() gets a directory of *.c files in wide format, and stores the directory in a local file, conypc.dir.