ReadDir Event

Fires when the OS wants to read (enumerate) a directory's contents.

Syntax

class FUSEReadDirEventParams {
public:
  const QString &Path();
  qint64 FillerContext();
  int Result();
  void SetResult(int iResult);
  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void ReadDir(FUSEReadDirEventParams *e);

// Or, subclass FUSE and override this emitter function.
virtual int FireReadDir(FUSEReadDirEventParams *e) {...}

Remarks

This event fires when the OS wants to enumerate the contents of the directory, identified by Path. In response to this event the application must call the Filler method and pass it FillerContextparameter as well as the information about the directory entry. Please, refer to the description of Filler for further details.

If Filler returns an error code, set Result to the returned code (do not negate the code). If there are no more files to pass, set Result to 0.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason (e.g., a resource isn't available, security checks failed, etc.), set it to a negative error code value (e.g. -ENOENT to indicate that the file does not exist) to report an appropriate error. Please refer to the Error Reporting and Handling topic for more information.