Listing Files on the AFTP Client Computer

File list facilities can be used to support wildcard transfers to the AFTP server. Wildcard processing is not allowed by the aftp_send_file and aftp_receive_file functions to make these functions as portable as possible. Obtaining a complete directory listing requires three calls: open, read, and close. The read function can be called multiple times to support wildcard processing.

aftp_local_dir_close

Closes an active directory listing on the AFTP client.

aftp_local_dir_open

Begins a directory listing operation on the AFTP client. The directory open call sets up the search specifications:

• File specification to be matched.
• Whether directories, files, or both should be included in the search.
• The type of information desired (file names only or file names with attributes).

aftp_local_dir_read

Gets the next file from the directory listing on the AFTP client. A text string describing the file is returned. The format of the information returned depends upon the parameters specified on the aftp_local_dir_open call.