ListDir Method

Lists the contents of a remote directory.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
char* ListDir(int bIncludeFiles, int bIncludeDirectories);

Unicode (Windows)
LPWSTR ListDir(BOOL bIncludeFiles, BOOL bIncludeDirectories);

- (NSString*)listDir:(BOOL)includeFiles :(BOOL)includeDirectories;

#define MID_FTPCLIENT_LISTDIR 22

SECUREBLACKBOXLITE_EXTERNAL int SECUREBLACKBOXLITE_CALL SecureBlackboxLite_FTPClient_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

Use the IncludeFiles and IncludeDirectories parameters to tune up the output. The output of IncludeFiles also includes symbolic links.

This method returns a human-readable string containing the requested list. It also fires ListEntry for each entry in the list, propagating its details in CurrentListEntry.

This method uses some heuristics internally by choosing the most appropriate listing method among MLSD, NLST, and LIST.

Error Handling (C++)

This method returns a String value; after it returns, call the GetLastErrorCode() method to obtain its 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.