ListDirectory Method
List the current directory specified by RemotePath on an FTP server.
Syntax
ANSI (Cross Platform) int ListDirectory(); Unicode (Windows) INT ListDirectory();
- (void)listDirectory;
#define MID_FTP_LISTDIRECTORY 9 IPWORKS_EXTERNAL int IPWORKS_CALL IPWorks_FTP_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);
Remarks
This method is used to list the directory (or file mask) specified in RemoteFile. RemoteFile is either an absolute path on the server, or a path relative to RemotePath. The file listing is received through the DirList event.
Similar to ListDirectoryLong, except only file names are returned.
Note that since RemoteFile acts as a file mask, to retrieve a complete directory listing RemoteFile should be set to empty string or a mask like "*". If there is no FTP session in place, one is automatically created by first calling the Logon method.
Error Handling (C++)
This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)