The GetFileList method returns a list of files in the
specified directory, copying the data to a string buffer. Unlike
the ReadDirectory method that parses a directory listing,
this method returns the unparsed file list data. The actual format
of the data that is returned depends on the operating system and
how the server implements file listings. For example, UNIX servers
typically return the output from the /bin/ls command.
Some servers may not support file listings for any directory other
than the current working directory. If an error is returned when
specifying a directory name, try changing the current working directory
using the ChangeDirectory method and then call this method
again, an empty string as the RemotePath parameter.
This method can be particularly useful when the client is
connected to a server that returns file listings in a format that is
not recognized by the control. The application can retrieve the
unparsed file listing from the server and parse the contents. Note
that if you specify the fileListNameOnly option, the data will
only contain a list of file names and there will be no way for the
application to know if they represent a regular file or a
This method is supported for both FTP and SFTP (SSH) connections,
however the format of the data may differ depending on which protocol
is used. Most UNIX based FTP servers will not list files and
subdirectories that begin with a period, however most SFTP servers
will return a list of all files, even those that begin with a period.
This method will cause the current thread to block until the file
listing completes, a timeout occurs or the operation is canceled.