ListDirectoryLong Method

List extended directory information for RemotePath .

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int ListDirectoryLong();

Unicode (Windows)
INT ListDirectoryLong();

- (void)listDirectoryLong;

#define MID_FTP_LISTDIRECTORYLONG 10

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 request a directory (or file mask) listing 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. Extended file information is 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.)