Event type signalled when a directory listing is needed for an FTP client connection.

TOnListDirectoryEvent = procedure (ASender: TIdFTPServerThread; const APath: string; ADirectoryListing: TIdFTPListItems) of object;

Collection of file items for the listing.

File system directory for the listing.

Client connection for the event notification.

TOnListDirectoryEvent is an event type signalled when an FTP server implementation needs to prepare and process a directory listing for the client connection.

TOnListDirectoryEvent is the event type signalled to the TIdFTPServer.OnListDirectory event handler when the command event handler for the FTP LIST command verb is executed. TOnListDirectoryEvent allows the server to examine, validate, or maintain items that appear in the directory listing.

The event handler allows the server to use properties from the connection for the thread client specified in ASender, the current directory in APath, and the collection with file information in ADirectoryListing. The event handler can also add or delete TIdFTPListItem entries in ADirectoryListing prior to constructing the text returned in to the client connection.

An FTP server implementation must assign a procedure to the event handler for the TOnListDirectoryEvent event to allow responding to the event notification.