Listing Files on the AFTP Server Computer

File list facilities can be used to support wildcard transfers from 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_dir_close

Closes an active directory listing on the AFTP server.

aftp_dir_open

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

• File specification that is 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_dir_read

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